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Preface 


This book is intended to serve as a source and a reference for the assembly language 
programmer. It contains an overview of assembly language programming fora partic- 
ular microprocessor and a collection of useful subroutines. In the subroutines, a 
standard format, documentation package, and parameter passing techniques were 
used. The rules of the most popular assemblers have been followed, and the purpose, 
procedure, parameters, results, execution time, and memory usage of each routine 
have been described. 

The overview sections summarize assembly language programming for those who 
do not have the time or need for a complete textbook; the Assembly Language 
Programming series provides more extensive discussions. Chapter | introduces 
assembly language programming for the particular processor and summarizes the 
major features that make this processor different from other microprocessors and 
minicomputers. Chapter 2 shows how to implement instructions and addressing 
modes that are not explicitly available. Chapter 3 describes common programming 
errors. 

The collection of subroutines emphasizes common tasks that occur in many applica- 
tions. These tasks include code conversion, array manipulation, arithmetic, bit 
manipulation, shifting functions, string manipulation, sorting, and searching. We 
have also provided examples of I/O routines, interrupt service routines, and initializa- 
tion routines for common family chips such as parallel interfaces, serial interfaces, and 
timers. You should be able to use these programs as subroutines in actual applications 
and as starting points for more complex programs. 

This book is intended for the person who wants to use assembly language imme- 
diately, rather than just learn about it. The reader could be 


- An engineer, technician, or programmer who must write assembly language 
programs for a design project. 


- A microcomputer user who wants to write an I/O driver, a diagnostic program, a 
utility, or a systems program in assembly language. 


Vii 
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- An experienced assembly language programmer who needs a quick review of 
techniques for a particular microprocessor. 


- A systems designer who needs a specific routine or technique for immediate use. 


- A high-level language programmer who must debug or optimize programs at the 
assembly level or must link a program written in a high-level language to one 
written in assembly language. 


- A maintenance programmer who must understand quickly how specific assembly 
language programs work. 


- A microcomputer owner who wants to understand the operating system for a 
particular computer or who wants to modify standard I/O routines or systems 
programs. 


- A student, hobbyist, or teacher who wants to see examples of working assembly 
language programs. 


This book can also serve as a supplement for students of the Assembly Language 
Programming series. 

This book should save the reader time and effort. The reader should not have to 
write, debug, test, or optimize standard routines or search through a textbook for 
particular examples. The reader should instead be able to obtain easily the specific 
information, technique, or routine that he or she needs. This book has been organized 
and indexed for rapid use and reference. 

Obviously, a book with such an aim demands feedback from its readers. Although 
all the programs have been thoroughly tested and carefully documented, please inform 
the publisher if you find any errors. If you have suggestions for better methods or for 
additional topics, routines, programming hints, or index entries, please tell us about 
them. We have used our programming experience to develop this book, but your help 
is needed to improve it. We would greatly appreciate your comments, criticisms, and 
suggestions. 


NOMENCLATURE 


We have used the following nomenclature in this book to describe the architecture of 
the Z80 processor, to specify operands, and to represent general values of numbers and 
addresses. 
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Z80 Architecture 


Byte-length registers include 


A (accumulator) R (refresh) 


crrmopaw 


A’ 
B’ 
C’ 
D’ 
E’ 
H’ 


F (flags) Ly 
I (interrupt vector) F’ 


Of these, the primary user registers are the first seven: A, B, C, D, E, H, and L. The I 
(interrupt vector) register contains the more significant byte (page number) of inter- 
rupt service addresses in Interrupt Mode 2. The R (refresh) register contains a memory 
refresh counter. The F (flag) register consists of a set of bits with independent functions 
and meanings, organized as shown in the following diagram: 


6 5 4 3 2 1 O <———Bit Number 


7 
Processor Status Register F 


Carry 

Add/ Subtract 
Parity/ Overflow 
Not Used (Logic 1) 
Auxiliary Carry 
Not Used (Logic 1) 
Zero 

Sign 


Register pairs and word-length registers include 


AF 
AF’ 
BC 
BC’ 
DE 
DE’ 
HL 
HL’ 


(Accumulator and flags, accumulator most significant) 
(Registers A’ and F’, A’ most significant) 
(Registers B and C, B most significant) 
(Registers B’ and C’, B’ most significant) 
(Registers D and E, D most significant) 
(Registers D’ and E’, D’ most significant) 
(Registers H and L, H most significant) 
(Registers H’ and L’, H’ most significant) 
(Index register X or IX) 

(Index register Y or IY) 

(Program counter) 

(Stack pointer) 


Flags include 


Add/Subtract (N) 
Carry (C) 
Auxiliary Carry (Ac) 
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Parity /Overflow (P/O or P/V) 
Sign (S) 
Zero (Z) 


These flags are arranged in the F register as shown previously. 


Miscellaneous facilities include 


Interrupt Flip-flop | (IFF1) 
Interrupt Flip-flop 2 (IFF2) 


Z80 Assembler 


Delimiters include 


: After a label, except for EQU, DEFL, and MACRO, which require a space 
Space After an operation code 

: Between operands in the operand (address) field 

: Before a comment 

(,) Around memory references 


All operands are treated as data unless they are enclosed in parentheses. 


Pseudo- Operations include 


DB or DEFB Define byte; place byte-length data in 
memory. 

DEFL Define label (may be redefined later). 

DEFM Define string; place ASCII data in memory. 

DS or DEFS Define storage; allocate bytes of memory. 

DW or DEFW Define word; place word-length data in 
memory. 

END End of program. 

EQU Equate; define the attached label. 

ORG Set origin; place subsequent object code 


starting at the specified address. 


Designations include 


Number systems: 


B (suffix) Binary 

D (suffix) Decimal 

H (suffix) Hexadecimal 
Q (suffix) Octal 


The default mode is decimal; hexadecimal numbers must start with a digit (you must 
add a leading zero if the number starts with a letter). 


Others: 


69 


or “ "ASCII (characters surrounded by single or double quotation marks) 
$ Current value of location (program) counter 


General Nomenclature 


ADDR 
ADDRI 
ADDR2 
BASE 
BICON 
CONST 
DEST 


HIGH 
INDIR 


LOW 
MASK 
n 


NPARAM 
NEXT 
NRESLT 
NTIMES 
NTIML 
NTIMM 
NUM 
NUMI 
NUM2 
OFF 
OFFSET 
oper 


OPER 
OPER! 
OPER2 
reg 
regl 
RETPT 
rp 

rph 

rpl 

rp! 
rplh 
rpll 
rp2 
rp2h 
rp2] 
SPTR 
STRNG 
SUM 
TEMP 
VAL16 
VALI6H 
VALI6L 
VALUE 


XY 


A 16-bit address in data memory 

A 16-bit address in data memory 

A 16-bit address in data memory 

A constant 16-bit address in data memory 

An 8-bit data item in binary format 

A constant 8-bit data item 

A 16-bit address in program memory, the 
destination for a jump instruction 

A 16-bit data item 

A 16-bit address in data memory, the start- 
ing address for an indirect address. The 
indirect address is stored in memory 
locations INDIR and INDIR+1. 

A 16-bit data item 

An 8-bit number used for masking 

A bit position in a byte; possible values are 
0 through 7 

A 16-bit data item 

A 16-bit address in program memory 

A 16-bit data item 

An 8-bit data item 

An 8-bit data item 

An 8-bit data item 

A 16-bit data item 

A 16-bit address in data memory 

A 16-bit address in data memory 

An 8-bit fixed offset 

An 8-bit fixed offset 

An 8-bit data item, a register, (HL), or an 
indexed address 

A 16-bit address in data memory 

A 16-bit address in data memory 

A 16-bit address in data memory 

A primary user register (A, B, C, D, E, H, or L) 

A primary user register 

A 16-bit address in program memory 

A primary register pair (BC, DE, or HL) 

The more significant byte of rp 

The less significant byte of rp 

A primary register pair 

The more significant byte of rpl 

The less significant byte of rp! 

Another primary register pair, not the same as rp1 

The more significant byte of rp2 

The less significant byte of rp2 

A 16-bit address in data memory 

A 16-bit address in data memory 

A 16-bit address in data memory 

A 16-bit address in data memory 

A 16-bit data item 

The more significant byte of VAL16 

The less significant byte of VALI16 

An 8-bit data item 

An index register, either IX or IY 


PREFACE Xi 


Chapter 1 General 
Programming Methods 


Some general methods for writing assembly language programs for the Z80 micro- 
processor are presented in this chapter. In addition, techniques for performing the 
following operations are explained: 


- Loading and saving registers 

- Storing data in memory 

- Arithmetic and logical functions 

- Bit manipulation and testing 

- Testing for specific values 

- Numerical comparisons 

- Looping (repeating sequences of operations) 
- Array processing and manipulation 
- Table lookup 

- Character code manipulation 

- Code conversion 

- Multiple-precision arithmetic 

- Multiplication and division 

- List processing 

- Processing of data structures. 


Also included in this chapter are special sections that describe passing parameters to 
subroutines, general methods for writing I/O drivers and interrupt service routines, 
and ways of making programs run faster or use less memory. 

The operations described are required in such applications as instrumentation, test 
equipment, computer peripherals, communications equipment, industrial control, 
process control, business equipment, aerospace and military systems, and consumer 
products. Microcomputer users will employ these operations in writing I/O drivers, 
utility programs, diagnostics, and systems software, and in understanding, debugging, 
and improving programs written in high-level languages. This chapter provides a brief 
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guide to Z80 assembly language programming for those who have an immediate 
application in mind. 


SUMMARY FOR EXPERIENCED PROGRAMMERS 


For those who are familiar with assembly language programming on other comput- 
ers, we provide here a brief review of the peculiarities of the Z80. Being aware of these 
unusual features can save a lot of time and trouble. 


1. Arithmetic and logical operations are allowed only between the accumulator and 
a byte of immediate data, the contents of a general-purpose register, the contents of the 
address in register pair HL, or the contents of an indexed address. Arithmetic and 
logical instructions do not allow direct addressing. 

For example, the alternatives for the OR instruction are OR CONST, where CONST 
is a fixed data byte; OR reg, where reg is an 8-bit general-purpose register; OR (HL); 
and OR (xy+OFF). The third alternative logically ORs the accumulator with the data 
byte located at the address in HL. The fourth alternative logically ORs the accumula- 
tor with the data byte located at an indexed address; the processor determines the 
address by adding the 8-bit offset OFF toa 16-bit index register. 


2. The accumulator and register pair HL are special. The accumulator is the only 
byte-length register that can be loaded or stored directly. The accumulator is also the 
only register that can be complemented, negated, shifted with a single-byte instruction, 
loaded indirectly from the addresses in register pairs BC or DE, stored indirectly at the 
addresses in register pairs BC or DE, or used in IN and OUT instructions with direct 
addressing. 

HL is the only register pair that can serve as an indirect address in arithmetic or logi- 
cal instructions or in loading or storing registers other than the accumulator. HL 1s also 
the only register pair that can be transferred to the program counter or stack pointer. 
Furthermore, HL serves as a double-length accumulator in 16-bit addition and sub- 
traction. Register pair DE is also special because the instruction EX DE,HL can 
exchange it with HL. Thus, the Z80’s registers are highly asymmetric, and the pro- 
grammer must carefully choose which data and addresses go in which registers. 


3. There are often several names for the same physical register. The registers A, B, 
C, D, E, H, and L are all available as 8-bit registers. The register pairs BC (B more 
significant), DE (D more significant), and HL (H more significant) are also available 
as 16-bit register pairs in many instructions. The terms “register pair B,” “registers B 
and C,” and “register pair BC” all have the same meaning, and there are similar 
variations for registers D and E and H and L. Note that the register pair and the two 
single registers are physically identical and cannot be used for different purposes at the 
same time. 
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In fact, H and L are almost always used to hold an indirect address because of the 
availability of instructions that access the data at that address as well as special 
instructions like LD SP,HL; JP (HL); EX (SP),HL; and EX DE,HL. Register pair DE 
is used for a second address when one is needed because of the EX DE,HL instruction. 
Registers B and C are generally used as separate 8-bit registers for temporary data 
storage and counters. 


4. The effects of instructions on flags are extremely inconsistent. Some particularly 
unusual effects are (a) logical instructions clear the Carry, (b) one-byte accumulator 
rotate instructions affect no flags other than the Carry, (c) load, store, transfer, 
increment register pair or index register, and decrement register pair or index register 
instructions affect no flags at all, and (d) 16-bit addition(ADD HL or ADD xy) affects 
only the Carry flag. Table A-1 in Appendix A can be used as an aid in determining how 
an instruction affects the flags. 


5. There is no indirect addressing through memory locations. The lack of indirect 
addressing is overcome by loading the indirect address into register pair HL. Thus, 
indirect addressing is a two-step process. The indirect address can also be loaded into 
registers pair BC or DE, but it can then only be used to load or store the accumulator. 


6. The Z80’s indexing allows only an 8-bit fixed offset in the instruction. Its main 
purpose is to implement postindexing and to allow offsets in data structures. A more 
general form of indexed addressing requires an explicit 16-bit addition of register pairs 
using HL as a 16-bit accumulator. Thus, indexing usually requires several steps: The 
index must be loaded into one register pair, the base address must be loaded into 
another register pair (one pair must be HL), the two must be added explicitly (using 
ADD HL,rp), and the sum must be used as an indirect address (by referring to (HL)). 
Generalized indexing on the Z80 is a long, awkward process. 


7. There is a combined Parity/ Overflow indicator. This flag indicates even parity 
after all instructions that affect it except addition and subtraction. Then it indicates the 
occurrence of two’s complement overflow. 


8. Many common instructions are missing but can easily be simulated with register 
operations. Some examples are clearing the accumulator (use SUB A or XOR A), 
clearing the Carry flag (use AND A or OR A), and logically shifting the accumulator 
left (use ADD A,A). Either AND A or OR A clears the Carry flag and sets the other 
flags according to the contents of the accumulator. But remember, loading a register 
does not affect any flags. 


9. There are both relative and absolute branches (using the operation codes JR and 
JP, respectively). Both addressing methods are allowed for unconditional branches. 
The sets of conditional branches differ; relative branches exist only for the Carry and 
Zero flags, whereas absolute branches exist for the Carry, Sign, Parity/ Overflow, and 
Zero flags. What is interesting here is that the relative branches occupy less memory 
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than the corresponding absolute branches (2 bytes rather than 3) but execute more 
slowly if the branch is taken (12 cycles rather than 10). 


10. Increment and decrement instructions behave differently, depending on whether 
they are applied to 8-bit or 16-bit operands. Decrementing or incrementing an 8-bit 
register affects all flags except the Carry. Decrementing or incrementing a 16-bit 
register pair or index register does not affect any flags at all. A 16-bit register pair can 
be used as a counter, but the only way to test the pair for zero is to logically OR the two 
bytes together in the accumulator. The 16-bit instructions are intended primarily for 
address calculations, not for data manipulation. 


11. Instructions that are additions to the original 8080 instruction set occupy more 
memory and execute more slowly than other instructions with similar functions and 
addressing modes. Among them are bit manipulation, arithmetic shift, logical shift, 
shifts of registers other than the accumulator, and some loads. These instructions 
execute more slowly because they require a prefix byte that tells the processor the 
instruction is not an original 8080 instruction and the next byte is the real operation 
code. Weller makes it easier to recognize the secondary instructions by using mnemon- 
ics derived from the 8080 instruction set.! 


12. Certain registers and facilities are clearly secondary in importance. The pro- 
grammer should employ them only when the primary registers and facilities are 
already in use or too inconvenient to use. The secondary facilities, like the secondary 
instructions, represent additions to the underlying 8080 microprocessor. The most 
important additions are index registers IX and IY; many instructions use these 
registers, but they take more memory and much more time than instructions that use 
the other register pairs. Another addition is the primed register set. Only two instruc- 
tions (EX ’AF,AF’ and EXX) allow access to the primed set, and for this reason 
programmers generally reserve it for functions such as fast interrupt response. 


13. Operations that can be done directly to a general-purpose register are shift it, 
transfer it to or from another register, load it with a constant, increment it by 1, or 
decrement it by 1. These operations can also be performed indirectly on the memory 
address in HL or on a memory location addressed via indexing. 


14. Only register pairs or index registers can be moved to or from the stack. One 
pair is AK which consists of the accumulator (more significant byte) and the flags (less 
significant byte). The CALL and RET instructions transfer addresses to or from the 
stack; there are conditional calls and returns but they are seldom used. 


15. The Z80 has a readable interrupt enable flag. One can determine its value by 
executing LD A,I or LD A,R. Either instruction moves the Interrupt flip-flop to the 
Parity / Overflow flag. That flag then reflects the state of the interrupt system at a 
particular time, and thus can be used to restore the state after the processor executes 
code that must run with interrupts disabled. 
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16. The Z80 uses the following common conventions: 


- The 16-bit addresses are stored with the less significant byte first (that is, at the 
lower address). The order of the bytes in an address is the same as in the 8080, 8085, and 
6502 microprocessors, but the opposite of that used in the 6800 and 6809. 


- The stack pointer contains the lowest address actually occupied by the stack. This 
convention is also used in the 8080, 8085, and 6809 microprocessors, but the obvious 
alternative (next available address) is used in the 6502 and 6800. Z80 instructions store 
data in the stack using predecrementing (they subtract | from the stack pointer before 
storing a byte) and load data from the stack using postincrementing (they add I to the 
stack pointer after loading a byte). 


- The interrupt (enable) flag is 1 to allow interrupts and 0 to disallow them. This 
convention is the same as in the 8080 and 8085, but the opposite of that used in the 
6502, 6800, and 6809. 


REGISTER SET 


Z80 assembly language programming is complicated by the asymmetry of the 
processor’s instruction set. Many instructions apply only to particular registers, 
register pairs, or sets of registers. Almost every register has its own unique features, 
and almost every instruction has its own peculiarities. Table 1-1 lists the 8-bit registers 
and the instructions that use them. Table 1-2 lists the 16-bit registers and the instruc- 
tions that use them (of course, all instructions change the program counter implicitly). 
Table 1-3 lists the indirect addresses contained in on-board register pairs and the 
instructions that use them. Table 1-4 lists the instructions that apply only to the 
accumulator, and Table 1-5 lists the instructions that apply only to particular 16-bit 
registers. Table 1-6 lists the instructions that apply to the stack. 

The general uses of the registers are as follows: 


- The accumulator, the center of data processing, is the source of one operand and 
destination of the result for most arithmetic, logical, and other processing operations. 


- Register pair HL is the primary memory address register. Instructions can often 
refer to the data at the address in HL, that is, (HL). 


- Register pair DE is the secondary memory address register because the pro- 
grammer can exchange its contents with HL using EX DE,HL. 


- Registers B and C (register pair BC) are general-purpose registers used mainly for 
counters and temporary data storage. Register B is often used as a loop counter 
because of its special usage in the DJNZ instruction. 


- Index registers IX and IY are used when the programmer is referring to memory 
addresses by means of fixed offsets from a variable base. These registers also serve as 
backups to HL when that register pair is occupied. 
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Table 1-4. Eight-Bit Registers and Applicable Instructions 


A only CPL, DAA; IN A,(port); LD (ADDR),LD (BC or DE), NEG; 
OUT (port),A; RLA, RLCA, RLD, RRA, RRCA, RRD. 


A,B,C,D,E,H,L ADC A; ADD A; AND, CP, DEC; IN reg,(C); INC, LD, OR; 
OUT (C),reg; RL, RLC, RR, RRC, SBC A; SLA, SRA, 
SRL, SUB, XOR 


B only DJNZ, IND, INDR, INI, INIR, OTDR, OTIR, OUTD, OUTI 


C only IN reg,(C); OUT (C),reg; IND, INDR, INI, INIR, OTDR, 
OTIR, OUTD, OUTI 


F (flags) CCE, SCF (see also AF register pair) 
I (interrupt vector) LD I,A; LD A,I 
R (refresh) LD R,A; LD A,R 





Table 4-2. Sixteen-Bit Registers and Applicable Instructions 


POP; PUSH; EX AKAF’ 
EX AFKAF’ 


ADC HL, ADD xy, ADD HL, CPD, CPDR, CPI, CPIR, 
DEC, EXX, INC, LD, LDD, LDDR, LDI, LDIR, POP, 
PUSH, SBC HL 


EXX 


ADC HL, ADD xy, ADD HL, DEC; EX DE,HL; EXX, INC, 
LD, LDD, LDDR, LDI, LDIR, POP, PUSH, SBC HL 


EXX 


ADC HL, ADD HL, CPD, CPDR, CPI, CPIR, DEC; EX 
DE,HL; EX (SP),HL; EXX, INC, IND, INDR, INI, INIR, 
LD, LDD, LDDR, LDI, LDIR, OTDR, OTIR, OUTD, 
OUTI, POP, PUSH, SBC HL 


HL’ EXX 
IX ADD IX, LD, POP, PUSH; EX (SP),IX 
IY ADD IY, LD, POP, PUSH; EX (SP),IY 


Program Counter CALL instructions, JP, JR, RETURN instructions, RETI, 
RETN, RST 


Stack Pointer CALL instructions, ADD HL, DEC, INC, LD, POP, PUSH, 
RETURN instructions, RST 
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Table 4-3. Indirect Addresses and Applicable Instructions 


Register pair BC LD A,(BC); LD (BC),A 
Register pair DE LD A,(DE); LD (DE),A 


Register pair HL* ADC A; ADD A; AND, CP, DEC, INC, JP, LD, OR, SBC 
A; SUB, XOR 


Stack Pointer CALL instructions, POP, PUSH, RETURN instructions, 
RST 


Index register 
X or Y 


* Index register X or Y can also be used as an indirect address for the same instructions as HL by 
specifying indexed addressing with a fixed offset of zero. 





Table 41-4. Instructions That Apply Only to the Accumulator 


ADCA Add with carry 

ADDA Add 

AND Logical AND immediate 

CPL One’s complement 

CP Compare 

DAA Decimal adjust (decimal correction) 
IN A,(port) Input direct 

LD A,(ADDR) Load direct 

LD A,(rp) Load indirect 


NEG Two’s complement (negate) 

OR Logical OR 

OUT (port),A Output direct 

RLA Rotate accumulator left through carry 
RLCA Rotate accumulator left 


RRA Rotate accumulator right through carry 
RRCA Rotate accumulator right 

SBCA Subtract with borrow 

SUB Subtract 

XOR Logical EXCLUSIVE OR 
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Table 41-5. Instructions That Apply Only to One or Two 16-Bit Registers 


EX AEAF’ AEAF’ Exchange program status with alternate 
program status 


EX DE,HL DE,HL Exchange HL with DE 


EX (SP),HL HL Exchange HL with top of stack 

EX (SP),xy IX or IY Exchange index register with top of stack 
LD SRHL HL,SP Load stack pointer from HL 

LD SP,xy IX or IY,SP Load stack pointer from index register 





Table 4-6. Instructions That Use the Stack 


Call instructions Jump and save program counter in stack (including 
conditionals) 


EX (SP),HL Exchange HL with top of stack 
EX (SP),xy Exchange index register with top of stack 
POP Load register pair from stack 


PUSH | Store register pair in stack 


RETURN instructions Load program counter from stack (including 
conditionals) 


RST Jump to vector address and save program 
counter in stack 





We may describe the special features of particular registers as follows: 


- Accumulator. Only single register that can be loaded or stored directly. Only 8-bit 
register that can be shifted with a one-byte instruction. Only register that can be 
complemented, decimal adjusted, or negated with a single instruction. Only register 
that can be loaded or stored using the addresses in register pairs BC or DE. Only 
register that can be stored in an output port or loaded from an input port using direct 
addressing. Source and destination for all 8-bit arithmetic and logical instructions 
except DEC and INC. Only register that can be transferred to or from the interrupt 
vector (I) or refresh (R) register. 


- Register pair HL. Only register pair that can be used indirectly in the instructions 
ADC, ADD, AND, CMP, DEC, INC, OR, SBC, SUB, and XOR. Source and 
destination for the instructions ADC HL, ADD HL, and SBC HL. Only register pair 
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that can be exchanged with register pair DE or with the top of the stack. Only register 
pair that can have its contents moved to the stack pointer (LD SP,HL) or the program 
counter (JP (HL)). Only register pair that can be shifted with a single instruction 
(ADD HL,HL). Automatically used as a source address register in block move, block 
compare, and block output instructions. Automatically used as a destination address 
register in block input instructions. 


- Register pair DE. Only register pair that can exchanged with HL (EX DE,HL). 
Automatically used as a destination address register in block move instructions. 


- Register pair BC. Automatically used as a counter in block move and block 
compare instructions. 


- Register B. Automatically used as a counter in the DJNZ instruction and in block 
input and output instructions. 


- Register C. Only register that can be used as an indirect port address for input and 
output. Automatically used as a port address in block input and output instructions. 


- Index registers IX and TY. Only address registers that allow an indexed offset. 
Used as source and destination in ADD xy instruction. Can be exchanged with the top 
of the stack, moved to the stack pointer or program counter, or shifted with ADD 


XY,XyY. 


- Stack pointer. Automatically postincremented by instructions that load data from 
the stack and predecremented by instructions that store data in the stack. Only address 
register that can be used to transfer other register pairs to or from memory (PUSH and 
POP) or to transfer the program counter to or from memory (CALL instructions and 
RETURN instructions). 


Note the following: 


- The A register is the only 8-bit register that can be loaded from memory or stored 
in memory using direct addressing. 


- Only the address in register pair HL or an address obtained via indexing can be 
used in operations other than loading and storing the accumulator. That is, only the 
data at the address in HL or at an indexed address can be moved to or from a user 
register, decremented, incremented, or used in arithmetic and logical operations. 


- Only DEC reg and INC reg perform 8-bit arithmetic operations without involving 
the accumulator (of course, DEC and INC may be applied to the accumulator). 


- Only index registers [X and IY allow an offset from a base address. The data at the 
indexed address can be. used like the data at the address in HL. 


- The index registers IX and IY make useful backups to HL because of the 
availability of the 16-bit instructions ADD xy; EX (SP),xy; JP (xy); and LD SP,xy. 
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Register Transfers 


The LD instruction can transfer any 8-bit general-purpose register (A, B, C, D, E, H, 
or L) to any other 8-bit general-purpose register. The flag (F) register can only be 
transferred to or from the stack along with the accumulator (PUSH AF and POP AF). 
Register pairs DE and HL can be exchanged using EX DE,HL. 

The common transfer instructions are 


- LD A,reg transfers the contents of reg to the accumulator 

- LD reg,A transfers the contents of the accumulator to reg 

* LDreg,(HL) loads reg with the contents of the memory address in register pair HL 
* LD (HL),reg stores reg at the memory address in register pair HL 

* EX DE,HL exchanges register pair DE with HL. 


The destination always comes first in the operand field of LD. That is, LD regl,reg2 
transfers the contents of reg2 to regl, the opposite of the convention proposed in IEEE 
Standard 694 for assembly language instructions. The LD changes the destination, 
but leaves the source as it was. Note that EX DE,HL changes all four registers (D, E, 
H, and L); it is thus equivalent to four LDs plus some intermediate steps that save one 
byte of data while transferring another. 


LOADING REGISTERS FROM MEMORY 


The Z80 microprocessor has five addressing modes that can be used to load registers 
from memory. These addressing modes are: Direct (from a specific memory address), 
Immediate (with a specific value), Indirect (from an address stored in a register pair), 
Indexed (from an address obtained by adding a fixed offset to an index register), and 
Stack (from the top of the stack).3 


Direct Loading of Registers 


The accumulator, a primary register pair (BC, DE, or HL), the stack pointer, or an 
index register can be loaded from memory using direct addressing. 


Examples 
1. LD A,(2050H) 


This instruction loads the accumulator (register A) from memory location 2050 j6. 
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2. LD HL,(0A000H) 


This instruction loads register L from memory location A000 6 and register H from 
memory location. A001 16 Note the standard Z80 practice of storing 16-bit numbers 
with the less significant byte at the lower address, followed by the more significant byte. 


3. LD SP(9A12H) 


This instruction loads the stack pointer from memory locations 9A12j¢ (less signifi- 
cant byte) and 9A13)¢ (more significant byte). 


immediate Loading of Registers 


Immediate addressing can be used to load any register, register pair, or index register 
with a specific value. The register pairs include the stack pointer. 


Examples 


1. LD C,6 


This instruction loads register C with the number 6. The 6 is an 8-bit data item, nota 
16-bit address. Do not confuse the number 6 with the address 0006 j¢. 


2. LD DE,1ISE3H 
This instruction loads register D with 15)6 and register E with E3 4g. 


3. LD IY,OB7EEH 
This instruction loads index register TY with B7EE j¢. 


Indirect Loading of Registers 


The instruction LD reg,(HL) can load any register from the address in register pair 
HL. The instruction LD A,(rp) can load the accumulator using the address in a register 
pair (BC, DE, or HL). Note that there is no instruction that loads a register pair 
indirectly. 


Examples 


1. LD D\(HL) 


This instruction loads register D from the memory address in register pair HL. The 
assembly language instruction takes the form “LD destination register, source regis- 
ter”; the order of the operands is the opposite of that proposed for IEEE Standard 
694.4 
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2. LD ABC) 


This instruction loads the accumulator from the memory address in register pair 
BC. Note that you cannot load any register except A using BC or DE indirectly. 


Indexed Loading of Registers 


The instruction LD A,(xy+OFFSET) loads the accumulator from the indexed 
address obtained by adding the 8-bit number OFFSET to the contents of an index 
register. Note that OFFSET is a fixed 8-bit number (its value is part of the program), 
while the index register contains a 16-bit address that can be changed. If OFFSET = 0, 
indexing is equivalent to indirection, but it is slower since the processor still must 
perform the address addition. 


Stack Loading of Registers 


The instruction POP rp or POP xy loadsa register pair or an index register from the 
top of the stack and adjusts the stack pointer appropriately. One register pair for POP 
rp is AE which consists of the accumulator (more significant byte) and the flags (less 
significant byte). No instructions load 8-bit registers from the stack or use the stack 
pointer indirectly without changing it (although EX (SP),HL and EX (SP),xy have no 
net effect on the stack pointer since they transfer data both to and from the stack). 


Examples 
1. POP DE 


This instruction loads register pair DE from the top of the stack and increments the 
stack pointer by 2. Register E is loaded first. 


2. POP TY 


This instruction loads index register TY from the top of the stack and increments the 
stack pointer by 2. The less significant byte of IY is loaded first. 
The stack has the following special features: 


- The stack pointer contains the address of the most recently occupied location. 
The stack can be anywhere in memory. 


- Data is stored in the stack using predecrementing—the instructions decrement 
the stack pointer by | before storing each byte. Data is loaded from the stack using 
postincrementing—the instructions increment the stack pointer by | after loading 
each byte. 


- As is typical with microprocessors, there are no overflow or underflow 
indicators. 
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STORING REGISTERS IN MEMORY 


The Z80 has four addressing modes that can be used to store registers in memory. 
These modes are: Direct (at a specific memory address), Indirect (at an address stored 
in a register pair), Indexed (at an address calculated by adding an 8-bit offset to the 
contents of an index register), and Stack (at the top of the stack). 


Direct Storage of Registers 


Direct addressing can be used to store the accumulator, a register pair (BC, DE, or 
HL), the stack pointer, or an index register. 


Examples 


1. LD (35C8H),A 


This instruction stores the accumulator in memory location 35C8 j¢. 


2. LD (203AH),HL 


This instruction stores register L in memory location 203Aj6 and register H in 
memory location 203Bj¢. 


3. LD (0A57BH),SP 


This instruction stores the stack pointer in memory locations A57Bij¢ (less signifi- 
cant byte) and A57Cj¢ (more significant byte). 


Indirect Storage of Registers 


The instruction LD (HL),reg can store any register at the address in register pair 
HL. The instruction LD (rp),A can store the accumulator at the address in a register 
pair (BC, DE, or HL). Note that there is no instruction that stores a register pair 
indirectly. 


Examples 

1. LD (HL),C 

This instruction stores register C at the address in register pair HL. The form is 
“move to address in HL from C.” 

2. LD (DE),A 


This instruction stores the accumulator at the memory address in register pair DE. 
Note that you cannot store any register except A using BC or DE indirectly. 
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indexed Storage of Registers 


The instruction LD (xy+OFFSET),A stores the accumulator at the indexed address 
obtained by adding the 8-bit number OFFSET to the contents of an index register. If 
OFFSET = 0, the indexed address is simply the contents of the index register, and 
indexing is reduced to a slow version of indirect addressing. 


Stack Storage of Registers 


The instruction PUSH rp or PUSH xy stores a register pair or an index register at 
the top of the stack and adjusts the stack pointer appropriately. One register pair is AF, 
consisting of the accumulator (more significant byte) and the flags (less significant 
byte). There is no instruction that stores an 8-bit register in the stack. 


Examples 


1. PUSH BC 


This instruction stores register pair BC at the top of the stack and decrements the 
stack pointer by 2. Note that B is stored first, so C ends up at the top of the stack. 


2. PUSH IX 


This instruction stores index register IX at the top of the stack and decrements the 
stack pointer by 2. Note that the less significant byte of IX is stored last, and thus it 
ends up at the top of the stack. 


OTHER LOADING AND STORING OPERATIONS 


Other loading and storing operations require more than one instruction. Some 
typical examples are 


1. Direct loading of a register other than A. 


LO A, (ADDR) 
LO reg,A 


An alternative is 


LQ HL, ADDR 
LD reg, CHL) 


The second approach leaves A unchanged, but makes HL an indirect addressing pair. 
Of course, the address in HL would then be available for later use. 
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2. Indirect loading of a register (from the address in memory locations INDIR and 
INDIR+1). 


LO HL, (INDIR) sGET INDIRECT ADDRESS 
LD reg, CHL) LOAD DATA INDIRECTLY 
3. Direct storage of a register other than A. 


LO A,reg 
LD (ADDR), A 


An alternative is 
LD HL, ADDR 
LO (HL),reg 


4. Indirect storage of a register (at the address in memory locations INDIR and 
INDIR+1). 


LD HL, (INDIR? ;GET THE INDIRECT ADDRESS 
LD (HL), reg ;STORE DATA THERE 
STORING VALUES IN RAM 


The usual ways to initialize RAM locations are (1 ) through the accumulator, (2) 
using register pair HL directly or indirectly, and (3) using an index register with a fixed 
offset. 


Examples 


1. Store an 8-bit item (VALUE) in address ADDR. 


LD A, VALUE 
LD CADDR),A 


Or 


LD HL, ADDR 
LO CHL), VALUE 


If VALUE = 0, we could use SUB A or XOR A instead of LD A, 0. Note, however, 
that SUB A or XOR A affects the flags, whereas LD A,0 does not. 


2. Store a 16-bit item (VALI6) in addresses ADDR and ADDR+1 (MSB in 
ADDR-+1). 


LD HL, VAL16 
LD (ADDR) ,HL 
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3. Store an 8-bit item (VALUE) at the address in memory locations INDIR and 
INDIR+1. 


Lo HL, CINDIR) GET INDIRECT ADDRESS 
LD CHL) , VALUE 7STORE DATA INDIRECTLY 


4. Store an 8-bit item (VALUE) nine bytes beyond the address in memory locations 
INDIR and INDIR+1. 


LD A, VALUE 
LD xy, CINDIR) 7;GET BASE ADDRESS 
Lo (xyt9),& 7;STORE DATA 9 BYTES BEYOND BASE 


Here the indirect address is the base address of an array or other data structure. 


ARITHMETIC AND LOGICAL OPERATIONS 


Most arithmetic and logical operations (addition, subtraction, AND, OR, EXCLU- 
SIVE OR, and comparison) can be performed only between the accumulator and an 
8-bit register, a byte of immediate data, or a byte of data in memory addressed through 
register pair HL or via indexing. Note that arithmetic and logical instructions do not 
allow direct addressing. If a result is produced (comparison does not produce any), it 
replaces the operand in the accumulator. 


Examples 


1. Logically OR the accumulator with register C. 
OR Cc 


OR C logically ORs register C with the accumulator and places the result in the 
accumulator. The programmer only has to specify one operand; the other operand and 
the destination of the result are always the accumulator. 


2. Add register B to the accumulator. 


Ano A,B 


ADD A,B adds register B to the accumulator (register A) and places the result in the 
accumulator. In the instructions ADC, ADD, and SBC, the programmer must specify 
both operands. The reason is that the Z80 also has the instructions ADC HL (add 
register pair to HL with carry), ADD HL (add register pair to HL), ADD xy (add 
register pair or index register to index register), and SBC HL (subtract register pair 
from HL with borrow). Note the inconsistency here: Both operands must be specified 
in ADC, ADD, and SBC, but only one operand in SUB; furthermore, the Z80 has an 
ADD xy instruction, but no ADC xy or SBC xy instruction. Since the 16-bit arithmetic 
instructions are mainly intended for addressing, we will discuss them later. 
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3. Logically AND the accumulator with the binary constant BICON. 
AND BICCIN 


Immediate addressing is the default mode; no special operation code or designation is 
necessary. 


4. Logically OR the accumulator with the data at the address in register pair HL. 


OR 


CHL) 


Parentheses indicate a reference to the contents of a memory address. 
Other operations require more than one instruction. Some typical examples are: 
- Add memory locations OPER 1! and OPER2, place sum in memory location SUM. 


Or 


or 


A, (QPER1) 7;GET FIRST OQPERAND 
E,A 

A, (QPER2) ?>GET SECOND OQFPERAND 
A,B 

CSUM),A 3; SAVE SLIM 

HL, OPER1 

A, CHL) s;GET FIRST OFERAND 
HL, OPER2 

A, CHL) s;ADD SECOND OPERAND 
HL, SLIM 

CHL, A ;SAVE SLIM 


We can shorten the second alternative considerably if the operands and the sum 
occupy consecutive memory addresses. For example, if OPER2 = OPERI + | and 
SUM = OPER2 + 1, we have 


LD 
Lo 
INC 
ADD 
INC 
LD 


HL, OPER1 

A, CHL) :GET FIRST OPERAND 
HL 

A, CHL) sADO SECOND OFERAND 
HL 

CHL)D,A SAVE SLIM 


- Add a constant (VALUE) to memory location OPER. 


Lo 
ADD 
LD 


LD 


ADD 
LD 


A, ((PER) 
A, VALUE 
(OPER), A 


HL, OPER 
A, CHL) 
A, VALUE 
(HL),A 
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If VALUE = 1, we can shorten the second alternative to 


LD HL, OPER 
INC CHL) 


You can use DEC (HL) similarly without changing the accumulator, but both DEC 
(HL) and INC (HL) affect all the flags except Carry. 


BIT MANIPULATION 


The Z80 has specific instructions for setting, clearing, or testing a single bit in a 
register or memory location. Other bit operations require a series of single-bit instruc- 
tions or logical instructions with appropriate masks. Complementing (CPL) applies 
only to the accumulator. Chapter 7 contains additional examples of bit manipulation. 

The specific bit manipulation instructions are 


SET n,reg 
RES n,reg 
BIT n,reg 
- Sets bit n of register reg 
- Clears bit n of register reg 
- Tests bit n of register reg, setting the Zero flag if that bit is 0 and clearing the Zero 
flag if it is 1. 


All three instructions can also be applied to (HL) or to an indexed address. Note that 
the bit position is not a variable; it is part of the instruction.° 

Other bit operations can be implemented by applying logical instructions to the 
accumulator as follows: 

- Set bits to 1 by logically ORing them with 1’s in the appropriate positions. 

- Clear bits by logically ANDing them with 0’s in the appropriate positions. 

- Invert (complement) bits by logically EXCLUSIVE ORing them with 1’s in the 
appropriate positions. 

- Test bits (for all 0’s) by logically ANDing them with 1’s in the appropriate 
positions. 


This approach is inconvenient since the logical instructions can only be applied to 
the accumulator. It does, however, allow the programmer to invert bits and change 
several bits at the same time. 


Examples 


1. Set bit 6 of the accumulator. 
SET 6,4 
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or 
OR 010000008 sSET BIT 6 BY ORING WITH 1 
Logically ORing a bit with 0 leaves it unchanged. 


2. Clear bit 3 of the accumulator. 
RES 3&3, 
or 
AND 12111201116 7;CLEAR BIT 3 BY ANDING WITH O 
Logically ANDing a bit with | leaves it unchanged. 


3. Invert (complement) bit 2 of the accumulator. 


XOR 00000100B 7; INVERT BIT 2 BY XORING WITH 1 


Logically EXCLUSIVE ORing a bit with 0 leaves it unchanged. Here there is no 
special bit manipulation instruction. Fortunately, setting and clearing bits are much 
more common operations than complementing bits. 


4. Test bit 5 of the accumulator. In other words, clear the Zero flag if bit 5 is 1, and 
set it if bit 5 is 0. 


BIT 3,A 
Or 
AND 00100000B s;TEST BIT 3 BY ANDING WITH 1 


Note the inversion here in either alternative: The Zero flag is set to | if the bit is 0, and 
to 0 if the bit is 1. 


5. Set bit 4 of register D. 
SET 4,D 


To use a logical function, we would have to load the data into the accumulator and 
load the result back into register D. 


6. Invert (complement) bit 7 of memory location ADDR. 


LD A, (ADDR) ;GET DATA 
XOR 10000000B ;COMPLEMENT BIT 7 
LD CADDR),A sRETURN RESULT TO MEMORY 


7. Set bit 0 of the memory location five bytes beyond the address in INDIR and 
INDIR+1. 


LD xy, (ADDR) ;GET INDIRECT ADDRESS 
SET 0, (xyt+5) 7SET BIT 0 OF BYTE 53 
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You can change more than one bit at a time by using a series of bit manipulation 
instructions or by using the logical functions with appropriate masks. 


8. Set bits 4 and 5 of the accumulator. 


OR 00110000B 7SET BITS 4 AND S BY GORING WITH 1 
or 

SET 4,A ;SET BIT 4 FIRST 

SET 3,A 7AND THEN SET BIT 53 


9. Invert (Complement) bits 0 and 7 of the accumulator. 
XOR 10000001B 7; INVERT BITS 0 AND 7 BY XORING WITH 1 


A handy shortcut to change bit 0 of a register or memory location is to use INC to set 
it Gf you know that it is 0) and DEC to clear it (if you know that it is 1). You can also use 
either INC or DEC to complement bit 0 if you are not using the other bits of a register 
or memory location. These shortcuts are useful when you are storing a single 1-bit flag 
in a register or memory location. 


SHIFT OPERATIONS 


The Z80 has shift instructions that operate on any register or memory location. 
Special instructions apply only to the accumulator, register pair HL, or an index 
register. Chapter 7 contains further examples of shift operations. 

The instructions RL and RR rotate a register or memory location and the Carry flag 
as if they formed a 9-bit register. Figures 1-1 and 1-2 show the effects of RL and RR. 
The instructions RLC and RRC rotate the register or memory location alone as shown 
in Figures 1-3 and 1-4. The bit shifted off the end still appears in the Carry flag as well 
as in the bit position at the other end. The instructions SLA and SRL perform logical 
shifts (as shown in Figures 1-5 and 1-6) which fill the bit at the far right or left witha 0. 
SRA performs an arithmetic shift (see Figure 1-7) which preserves the sign bit by 
extending (copying) it to the right. Note that RL and RR preserve the old Carry flag (in 
either bit 0 or bit 7), whereas the other shift instructions destroy it. 

Certain special instructions are shorter and faster than the regular shifts in specific 
situations. One-byte circular shifts (RLA, RLCA, RRA, RRCA) apply only to the 
accumulator. Adding a register to itself (ADD A,A; ADD HL,HL; ADD xy,xy) is 
equivalent to a logical left shift, while adding a register to itself with Carry(ADCA,A 
or ADC HL,HL) is equivalent to a left rotate through Carry. 


Examples 
1. Rotate accumulator right two positions without the Carry. 


RRCA 
RRCA 
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Original contents of Carry flag and register or memory location 
Carry Data 





Figure 1-4. The RL (rotate left through Carry) instruction 


Original contents of Carry flag and register or memory location 


After RR (rotate right through Carry) 
Carry Data 





Figure 4-2. The RR (rotate right through Carry) instruction 


Original contents of Carry flag and register or memory location 
Carry Data 


Pies eslee |e |en/ erie) 


After RLC (rotate left) 
Carry 





Figure 4-3. The RLC (rotate left) instruction 
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Original contents of Carry flag and register or memory location 


After RRC (rotate right) 
Carry Data 


Po }P [Be] Bs Js [Bs JB 1B 





Figure 4-4. The RRC (rotate right) instruction 


Original contents of Carry flag and register or memory location 


After SLA (shift left arithmetic) 


Be] Ps[ Pal Bs) [Bel Pol 





Figure 1-5. The SLA (shift left arithmetic) instruction 


Original contents of Carry flag and register or memory location 


After SRL (shift right logical) 





Figure 41-6. The SRL (shift right logical) instruction 
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Original contents of Carry flag and register or memory location 


[Br] Bs | Bs] Bs] Bs ] Bo | Bi | Bo| 


After SRA (shift right arithmetic) 






Figure 4-7. The SRA (shift right arithmetic) instruction 


Note the special form for the accumulator. 


2. Shift accumulator left logically two positions. 


SLA A 
SLA A 


A shorter, faster alternative is 


AnD A,A 
ADD A,A 


The instruction ADD A,A is equivalent to a logical left shift of A. Notethat ADD A,A 
is a one-byte instruction, whereas SLA is always at least a two-byte instruction since it 
is an addition to the 8080 instruction set. 


3. Shift register C right logically one position. 
SRL CC 


4. Shift register pair HL left logically two positions. 


ADD HL,HL 
A0D HL,HL 


ADD HL, HL is a one-byte logical left shift of HL. 
Shift instructions can also be applied to memory locations addressed either through 
register pair HL or through indexing from IX or IY. 


5. Shift memory location ADDR right one position, preserving the sign bit (bit 7). 


LO HL, ADDR 
SRA CHL) 


Shifting while preserving the sign bit is called sign extension. A shift that operates in 
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this manner is called an arithmetic shift, since it preserves the sign of a two’s comple- 
ment number. It can therefore be used to divide or normalize signed numbers. 


6. Rotate right the memory location eight bytes beyond the address in INDIR and 
INDIR+1. 


LD xy, (INDIR) GET INDIRECT ADDRESS 
RR (xy+8) s;ROTATE BYTE & RIGHT 


MAKING DECISIONS 


In this section procedures are presented for making the following three types of 
decisions: 


- Branching if a bit is set or cleared 
- Branching if two values are equal or not equal 
- Branching if one value is greater or less than another. 


The first type of decision allows the processor to sense the value of a flag, switch, 
status line, or other binary (ON/OFF) input. The second type of decision allows the 
processor to determine whether an input or a result has a specific value (an input is a 
specific command character or terminator, or a result is 0). The third type of decision 
allows the processor to determine whether a value is above or below a numerical 
threshold (a value is valid or invalid, or is above or below a warning level or setpoint). 
Assuming that the primary value is in the accumulator and the secondary value (if 
needed) is at address ADDR, the procedures are as follows. 
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Branching Set or Cleared Bit 


Determine if a bit is set or cleared with the BIT instruction. The operands are the bit 
position and the register or memory address (either the one in HL or one accessed via 
indexing). The Zero flag reflects the bit value and can be used for branching. 


Examples 
1. Branch to DEST if bit 5 of the accumulator is 1. 


BIT 5,4 
JR NZ, DEST 


JP (absolute addressing) can be used instead of JR (relative addressing). The Zero 
flag is set to 1 if and only if bit 5 of A is 0. 


2. Branch to DEST if bit 2 of register C is 0. 


BIT 2,C 
JR Z, DEST 


3. Branch to DEST if bit 6 of memory location ADDR is I. 
LD HL, ADDR 


BIT 4, (HL) 
uJIR NZ, DEST 


4. Branch to DEST if bit 3 of the memory location seven bytes beyond the address 
in INDIR and INDIR-+1 is 0. 


LO xy, CINDIR) 
BIT 3, txy+7) 
JR Z, DEST 


There are shortcuts for bits 0, 6, and 7 of the accumulator. 


5. Branch to DEST if bit 7 of the accumulator is 1. 


AND A s;ESTABLISH SIGN FLAG 
JF M, DEST 


There is no relative jump based on the Sign flag. 


6. Branch to DEST if bit 6 of the accumulator is 0. 


ADD A,A ESTABLISH SIGN FLAG FROM BIT 6 
JP P, DEST 


7. Branch to DEST if bit 0 of the accumulator is 1. 
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RRA ;MQVE BIT 0 TQ CARRY 
JR C, DEST 


Here we have the choice of either a relative or an absolute jump. 


Branching Based on Equality 


Determine if the value in the accumulator is equal to another value by subtraction. 
The Zero flag is set to 1 if the values are equal. Compare instructions (CP) are more 
useful than subtract instructions (SBC or SUB) because compares preserve the value in 
the accumulator for later operations. Note, however, that the Z80 has a 16-bit subtract 
with borrow instruction (SBC HL), but no 16-bit compare or subtract instruction. 


Examples 


1. Branch to DEST if the accumulator contains the number VALUE. 


CP VALUE ;DOES A CONTAIN VALUE? 
IR Z,DEST 7YES, BRANCH 


2. Branchto DEST if the contents of the accumulator are not equal to the contents 
of memory location ADDR. 


LD HL, ADDR 
CP CHL) 71S A THE SAME AS DATA IN MEMORY? 
JR NZ, DEST :NQ, BRANCH 


There are shortcuts if VALUE is 0, 1, or FF j¢. 


3. Branch to DEST if the accumulator contains 0. 


AND A ;ESTABLISH ZERO FLAG 
JR Z,DEST ;BRANCH IF A CONTAINS ZERO 


4. Branch to DEST if the accumulator does not contain FF j¢. 


INC A 7ESTABLISH ZERQ FLAG 
JR NZ, DEST 7 BRANCH IF A WAS NOT FF 


This procedure can be applied to any 8-bit register or to a memory location addressed 


through HL or via indexing. 


5. Branch to DEST if the accumulator contains 1. 


DEC A s;ESTABLISH ZERO FLAG 
JR Z,DEST 7 BRANCH IF A WAS 1 
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6. Branch to DEST if memory location ADDR contains 0. 
LO HL, ADDR 


INC CHL) sESTABLISH ZERO FLAG IN TWO STEPS 
DEC CHL) 
IR Z, DEST ;BRANCH IF ADDR CONTAINS ZERO 


This procedure will also work on data at an indexed address or in registers B, C, D, E, 
H, or L. 


7. Branch to DEST if register pair HL contains VALI6. 


AND A ;CLEAR CARRY, DON’T CHANGE A 
Lo rp, VAL16 

SBC HL,rp 7;DOES HL CONTAIN VAL167 

JR Z, DEST ;YES, BRANCH 


The 16-bit subtraction instruction always includes the Carry and is available only for 
HL and another register pair (BC, DE, or SP). 


Branching Based on Magnitude Comparisons 


Determine if the value in the accumulator is greater than or less than some other 
value by subtraction. If, as is typical, the values are unsigned, the Carry flag indicates 
which is larger. In general, 


- Carry = 1 if the value subtracted is larger than the value in the accumulator (that 
is, if a borrow is required). 


- Carry = 0 if the value in the accumulator is larger or if the two values are equal. 


Since subtracting equal values makes the Carry 0, the alternatives (considering the 
accumulator as the primary operand) are 


- Primary operand less than secondary operand (Carry set) 


- Primary operand greater than or equal to secondary operand (Carry cleared). 


If the alternatives you need are “less than or equal to” and “greater than,” you can 
simply exchange the primary and secondary operands (that is, from Y — X instead of 
MY). 


Examples 


1. Branch to DEST if the contents of the accumulator are greater than or equal to 
the number VALUE. 


CP VALUE ; 


A ABOVE VALUE? 
JR NC, DEST , 


BRANCH 
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2. Branch to DEST if the contents of memory address OPER] are less than the 
contents of memory address OPER2. 


Lo A, CQPER1L) ;GET FIRST OQPERAND 

LD HL, OPER2 

CP CHL) 71S IT LESS THAN SECOND OFERAND? 
JR C, DEST ;YES, BRANCH 


3. Branchto DEST if the contents of memory address OPER! are less than or equal 
to the contents of memory address OPER2. 


LD A, COPER2) 7;GET SECOND OFPERAND 

LO HL, OPER 1 

CP CHL) 7IS IT GREATER THAN OR EQUAL TO FIRST? 
JR NC, DEST 7YES, BRANCH 


If we loaded the accumulator with OPER1 and compared to OPER2, we could 
branch only on the conditions 


- OPERI greater than or equal to OPER2 (Carry cleared) 
- OPER! less than OPER2 (Carry set). 
Since neither is what we want, we must reverse the order in which the operands are 


handled. 


4. Branch to DEST if the contents of register pair HL are greater than or equal to 
VALI6. 


AND A ;CLEAR CARRY 

LO rp,VAL16 71S HL ABOVE VAL16? 
SBC HL,rp 

JR NC, DEST 7YES, BRANCH 


If the values are signed, we must allow for the possible occurrence of two’s comple- 
ment overflow.’ This is the situation in which the difference between the numbers 
cannot be contained in seven bits and, therefore, the sign bit is changed. For example, 
if one number is +7 and the other is —125, the difference is —132, which is beyond the 
capacity of eight bits (it is less than — 128, the most negative number that eight bits can 
hold). 

If overflow is a possibility, we can determine if it occurred by examining the 
Parity/ Overflow flag after the addition or subtraction instruction. If that flag is 1, 
overflow did occur. The mnemonics here are confusing, since the Parity/ Overflow flag 
normally indicates whether the result has even parity; the branches are therefore PE 
(Parity Even or Overflow Set) and PO (Parity Odd or Overflow Clear). Weller clarifies 
the situation by defining additional mnemonics JV and JNV.8 

Thus, in the case of signed numbers, we must allow for the following possibilities: 


- The result has the sign (positive or negative, as shown by the Sign flag) that we 
want, and the Parity/ Overflow flag indicates that the sign is valid. 
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- The result does not have the sign that we want, but the Parity/ Overflow flag 
indicates that two’s complement overflow has changed the real sign. 


We have to look for both a true positive (the sign we want, unaffected by overflow) 
ora false negative (the opposite of the sign we want, but inverted by two’s complement 
overflow). 


Examples 


1. Branch to DEST if the accumulator contains a signed number greater than or 
equal to the number VALUE. 
CP VALUE PERFORM THE COMPARISON 


uP PE, FNEG 7;DID QVERFLOW OCCUR? 
IP P, DEST ;NQ, BRANCH IF RESULT POSITIVE 


JR DONE 
FNEG: JP M, DEST ;YES, BRANCH IF RESULT NEGATIVE 
DONE : NOP 


There are no relative jumps based on the Parity/ Overflow flag. 


2. Branch to DEST if the accumulator contains a signed number less than the 
contents of memory address ADDR. 


LO HL, ADDR 


CP CHL) s;PERFORM THE COMPARISON 
IP PE,FPOS 7010 OVERFLOW OCCUR? 
JP M,DEST 7;NQ, BRANCH IF RESULT NEGATIVE 
AR DONE 
FPOQS: JP P, DEST 7;YES, BRANCH IF RESULT POSITIVE 
DONE : NOP 


Remember, JP PE means “jump on overflow,” while JP PO means “jump on no 
overflow.” 


The programmer should also note that this is one of the few cases in which the Z80 1s 
not fully upward-compatible with the 8080 microprocessor.? The 8080 has no overflow 
indicator and the P flag always indicates even parity. 

There are some cases in which overflow cannot occur and all we must do is use the 
Sign flag instead of the Carry flag for branching. These cases are the following: 


- The two numbers have the same sign. When this occurs, the difference is smaller in 
magnitude than the larger of the two numbers and overflow cannot occur. You can 
easily determine if two numbers have the same sign by EXCLUSIVE ORing them 
together and checking the Sign flag. Remember, the EXCLUSIVE OR of two bits is | if 
and only if the two bits have different values. 


XOR VALUE ;CQULD OVERFLOW OCCUR? 
uP FP, NOOVF NOT IF SIGNS ARE THE SAME 
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- A value is being compared with zero. In this case, the Sign flag must be set and 
examined. 


Examples 


1. Jump to DEST if the accumulator contains a signed positive number. 


AND A 7;SET FLAGS FROM VALUE IN A 
uIP P,DES 


2. Jump to DEST if an 8-bit register contains a signed negative number. 


INC reg :SET FLAGS FROM VALUE IN REGISTER 
DEC reg 
JP M, DEST 


This sequence does not affect the accumulator or the register. 


3. Jump to DEST if memory location ADDR contains a signed positive number. 


LD HL, ADDR ;PQOINT TO DATA IN MEMORY 
INC CHL) 

DEC ¢HL> 

UIP P, DEST 7;BRANCH IF DATA IS POSITIVE 


This sequence does not affect the accumulator or the memory location. 


Tables 1-7 and 1-8 summarize the common instruction sequences for making 
decisions with the Z80 microprocessor. Table 1-7 lists the sequences that depend only 
on the value in the accumulator; Table 1-8 lists the sequences that depend on numerical 
comparisons between the value in the accumulator and a specific number, the contents 
of a register, or the contents of a memory location (addressed through HL or an index 
register). Table 1-9 contains the sequences that depend only on the contents of a 
memory location. 


LOOPING 


The simplest way to implement a loop (that is, to repeat a sequence of instructions) 
with the Z80 microprocessor is to perform the following steps: 


1. Load register B with the number of times the sequence is to be repeated. 
2. Execute the sequence. 


3. Use the DJNZ instruction to decrement register B and return to Step 2 if the 
result is not 0. 


The DJNZ instruction is useful for loop control since it combines a decrement and a 
conditional relative branch. Note that DJNZ always operates on register B and 
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Table 4-7. Decision Sequences Depending on the Accumulator Alone 


Flag Setting Instruction Conditional Jump 


Any bit = 0 BIT n,A JR ZorJPZ 
Any bit = | BIT n,A JR NZ or JP NZ 
Bit 7= 0 RLA, RLCA, or ADD A,A JR NC or JP NC 
Bit 7= | RLA, RLCA, or ADD A,A JR Cor JPC 
Bit 6= 0 ADD A,A JP P 


Bit 6= | ADD A,A JPM 

Bit 0= 0 RRA or RRCA JR NC or JP NC 
BitO= | RRA or RRCA JR CorJPC 
Equals zero AND A or OR A JR ZorJPZ 
Not equal to zero AND A or OR A JR NZ or JP NZ 
Positive (MSB = 0) AND A or OR A JPP 

Negative (MSB= 1) AND A or OR A JPM 





Table 41-8. Decision Sequences Depending on Numerical Comparisons 
with the Accumulator (Using CP) 


Equal JR Zor JP Z 

Not equal JR NZ or JP NZ 

Greater than or equal (unsigned) JR NC or JP NC 

Less than (unsigned) JR Cor JPC 

Greater than or equal (signed) JP P (assuming no overflow) 


Less than (signed) JP M (assuming no overflow) 


Note: All conditions assume that the accumulator contains the primary operand; for example, 
less than means “accumulator less than other operand.” 





Table 41-9. Decision Sequences Depending on a 
Memory Location Alone 


Flag Setting Instruction(s) Conditional Jump 


Any bit = 0 BIT n, (HL) or (xy+ OFFSET) JR ZorJPZ 


Any bit = | BIT n,(HL) or (xy+OFFSET) JR NZ or JP NZ 
=0 INC,DEC JR Zor JPZ 
+0 INC,DEC JR NZ or JP NZ 
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branches if B is not decremented to 0 —the instruction set does not provide any other 
combinations. However, DJNZ has limitations: It allows only an 8-bit counter and an 
8-bit offset for the relative branch (the branch is thus limited to 129 bytes forward or 
126 backward from the first byte of the instruction). 

Typical programs look like the following: 


Ln 8 868,NTIMES — sNTIMES = NUMBER OF REPETITIONS 
LOOP: - 

. Instructions ta be repeated 

DINZ LOOP 


We could, of course, use other 8-bit registers or count up rather than counting down. 
These alternative approaches would require a slightly different initialization, an 
explicit DEC or INC instruction, and a conditional JR or JP instruction. In any case, 
the instructions to be repeated must not interfere with the counting of the repetitions. 
Note that register B is special, and most programmers reserve it as a loop counter. 

The 8-bit length of register B limits this simple loop to 256 repetitions. The 
programmer can provide larger numbers of repetitions by nesting single-register loops 
or by using a register pair as illustrated in the following examples: 


- Nested loops 


LO C,NTIMM START QUTER COUNTER 
LOOFO: LD B,NTIML *START INNER COUNTER 
LOOPI: ‘: 

; Instructians to be repeated 

DUINZ LOOPI *DECREMENT INNER COUNTER 

DEC C *DECREMENT OUTER COUNTER 


UR NZ,LOOQFO 


The outer loop restores the inner counter (register B) to its starting value (NTIML) 
after each decrement of the outer counter (register C). The nesting produces a 
multiplicative factor —the instructions starting at LOOPI are repeated NTIIMM X 
NTIML times. We use register B as the inner counter to take maximum advantage of 
DJNZ. (Clearly, the inner loop is executed many more times than the outer loop.) 


- A register pair as 16-bit counter 


LO BC,NTIMES s INITIALIZE 16-BIT COUNTER 
LOCP s é 

‘ Instructions to be repeated 

DEC BC 

LO A,B *TEST 16-BIT CQUNTER FOR ZERO 

OR C 


JR NZ, LOOP 


CHAPTER 1. GENERAL PROGRAMMING METHODS 33 


The extra steps are necessary because DEC rp (or DEC xy) does not affect the Zero 
flag (so there is no way of telling if the count has reached 0). The simplest way to 
determine if a 16-bit register pair contains 0 is to logically OR the two registers. The 
result of the logical OR is 0 if and only if all bits in both registers are 0’s. Check this 
procedure by hand if you are not sure why it works. A major drawback to this 
approach is its use of the accumulator, which requires saving the previous contents if 
they are needed in the next iteration. 


ARRAY MANIPULATION 


The simplest way to access a particular element of an array is to place the element’s 
address in register pair HL. In this way, it is possible to 


- Manipulate the element by referring to it indirectly, that is, as (HL). 


- Access the succeeding element (at the next higher address) by using INC to incre- 
ment register pair HL or access the preceding element (at the next lower address) by 
using DEC to decrement HL. 


- Access an arbitrary element by loading another register pair with the element’s 
offset from the address in HL and using the ADD HL instruction. If the offset is fixed, 
we can also use indexing from a base address in either index register. 


Typical array manipulation procedures are easy to program if the array is one- 
dimensional and the elements each occupy one byte. Some examples are 


- Add an element of an array to the accumulator. Assume that the address of the 
element is in register pair HL. Update HL so that it contains the address of the 
succeeding 8-bit element. 

ADD CHL) sADD CURRENT ELEMENT 
INC HL s;ADDRESS NEXT ELEMENT 

- Check to see if an element of an array is 0 and add | to register C if it is. Assume 
that the element’s address is in register pair HL. Update HL so that it contains the 
address of the preceding 8-bit element. 


Lo A, CHL) sGET CURRENT ELEMENT 

AND A ©Is IT ZERO? 

JR NZ,UPDOT 

Inc OC >YES, ADD 1 TO COUNT OF ZEROS 
UPDDT: DEC HL +ADDRESS PRECEDING ELEMENT 


- Load the accumulator with the 35th element of an array. Assume that the base 
address of the array is in register pair HL. 


LD DE, 35 7;GET OFFSET FOR REQUIRED ELEMENT 
ADD HL,DE sCALCULATE ADDRESS OF ELEMENT 


LD A, CHL) ;QBTAIN THE ELEMENT 
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ADD HL,DE performs a 16-bit addition, using register pair HL as a 16-bit accumu- 
lator. Note that the 16-bit offset in register pair DE can be either positive or negative. 

The following single instruction performs the same task if the offset is an 8-bit 
unsigned number and the base address is in an index register: 


LD A, (xyt35) ;QBTAIN THE ELEMENT IN ONE STEP 


Manipulating array elements becomes more difficult if more than one element is 
needed during each iteration (as in a sort that requires interchanging of elements), if 
the elements are more than one byte long, or if the elements are themselves addresses 
(as ina table of starting addresses). The basic problems are the lack of indexing witha 
variable offset and the lack of instructions that access 16-bit items indirectly. Some 
examples of more general array manipulation are 


- Load register pair DE with a 16-bit element of an array (stored LSB first). The 
starting address of the element is in register pair HL. Update HL so that it points to the 
next 16-bit element. 


LD E, CHL) ;GET LSE OF ELEMENT 
INC HL 

LD DQ, CHL) 3;GET MSB OF ELEMENT 
INC HL ;ADDRESS NEXT ELEMENT 


- Exchange an element of an array with its successor if the two are not already in 
descending order. Assume that the elements are 8-bit unsigned numbers and that the 
address of the current element is in register pair HL. Update HL so that it contains the 
address of the successor element. 


LD A, CHL) ;GET CURRENT ELEMENT 
INC CHL) 
CF CHL) 71S IT LESS THAN SUCCESSOR? 
JR NC, DONE 7NQ, NO INTERCHANGE NECESSARY 
LD B, CHL) 7;YES, START THE INTERCHANGE 
LD CHL), A ;CURRENT ELEMENT TQ NEW POSITION 
DEC HL 
Lo CHL),B ;SUCCESSOR ELEMENT TO NEW POSITION 
INC HL 
DONE: NCP 


This procedure is awkward because the processor can address only one element ata 
time using HL. Clearly, the problem would be even more serious if the two elements 
were more than one position apart. 

An alternative approach is to use an index register; that is, 


LD A, <xytO) ;GET CURRENT ELEMENT 
CP (xy+1) 71S IT LESS THAN SUCCESSOR? 
JR NC, DONE s;NOQ, NO INTERCHANGE NECESSARY 
LD B,{xyt+tO) YES, START THE INTERCHANGE 
LD (xyti),A  3CURRENT ELEMENT TO NEW POSITION 
LD (xytO),B  3;SUCCESSOR ELEMENT TO NEW POSITION 
DONE: INC xy ;MOVE ON TO NEXT PAIR 
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- Load the accumulator from the 12th indirect address in a table. Assume that the 
base address of the table is in register pair HL. 


LO DE, 24 *GET DOUBLED GFFSET FOR ELEMENT 

ADD HL,DE sCALCULATE STARTING ADDRESS OF ELEMENT 
LD E, CHL) sGET LSB QF INDIRECT ADDRESS 

ING HL 

LO ND, CHL) ;GET MSB OF INDIRECT ADDRESS 

LO A, (DE) sQBTAIN DATA FROM INDIRECT ADDRESS 


An alternative approach using an index register is 


LD A, (xyt24) ;GET LSB OF INDIRECT ADDRESS 


LD E,A 

LD A, (xy+25) ;GET MSB QF INDIRECT ADDRESS 

LO D,A 

LD A, (DE) 7;OBTAIN DATA FROM INDIRECT ADDRESS 


Note that in either approach you must double the index to handle tables containing 
addresses, since each 16-bit address occupies two bytes of memory. 


Some ways to simplify array processing are 


- Keep the base address of the table or array in register pair DE (or BC), so ADD HL 
or ADD xy does not destroy it. 


- Use ADD A,A to double an index in the accumulator. The doubled index can then 
be used to handle arrays or tables consisting of 16-bit elements. ADD HL,HL or ADD 
xy,xy may be used to double 16-bit indexes. 


- Use EX DE,HL to move addresses to and from register pair HL. 


Chapters 5 and 9 contain further examples of array manipulation. 


Block Move and Block Compare instructions 


Another way to simplify array processing is to use the Z80’s block move and block 
compare instructions. The block move instructions not only transfer data from one 
memory location to another without using the accumulator, but they also update the 
array pointers and decrement a 16-bit loop counter. Thus, a block move instruction 
can replace a sequence of load, increment, and decrement instructions. Repeated 
block move instructions continue transferring data, updating the pointers, and decre- 
menting the counter until the counter is decremented to zero. Block compare instruc- 
tions are similar to block moves, except that only a single pointer 1s involved (the other 
operand is in the accumulator), and the repeated versions also terminate if the 
operands being compared are equal (this is referred to as a true comparison). 

A further convenience of block moves and block compares is that they solve the 
problem of testing a 16-bit counter for 0. Both block moves and block compares clear 
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the Parity/ Overflow flag if the 16-bit counter (always in register pair BC) is decre- 
mented to zero, and set the Parity/ Overflow flag otherwise. Note that the indicator is 
the Parity/Overflow flag, not the Zero flag. 

The block move and compare instructions are the following: 


- LDI (LDD) moves a byte of data from the address in HL to the address in DE, 
decrements BC, and increments (decrements) DE and HL. 


- LDIR (LDDR) repeats LDI (LDD) until BC is decremented to 0. 


- CPI (CPD) compares the accumulator to the data at the address in HL, decre- 
ments BC, and increments (decrements) HL. Both CPI and CPD set the Zero flag if 
the operands being compared are equal, and clear the Zero flag otherwise. 


- CPIR (CPDR) repeats CPI (CPD) until BC is decremented to 0. 


Note that block moves reserve BC, DE, and HL for special purposes, while block 
compares reserve only BC and HL. 


Examples 


1. Move a byte of data from memory location ADDRI to memory location 
ADDR2. 


LD BC, 1 ;NUMBER OF BYTES TO MOVE = 1 

Lo DE,ADDORi ;INITIALIZE SOURCE POINTER 

LD HL,ADDR2 ;INITIALIZE DESTINATION POINTER 
LOI or LOD ;MQVE A BYTE OF DATA 


Obviously, the overhead of loading all the register pairs makes it uneconomical to use 
LDI or LDD to move a single byte of data. 


2. Move two bytes of data from memory locations ADDR! and ADDRI1-+1 to 
memory locations ADDR2 and ADDR2+1. 


LD BC, 2 ;NUMBER OF BYTES TQ MOVE = 2 

LD DE,ADDRL sINITIALIZE SOURCE POINTER 

LD HL,ADDR2 ;INITIALIZE DESTINATION POINTER 
LOIR 7;MOVE TWO BYTES OF DATA 


or 


LO BC,2 ;NUMBER OF BYTES TQ MQVE = 2 

LD DE,ADDRI+1 ; INITIALIZE SOURCE POINTER 

LD HL,ADDR2+1 s; INITIALIZE DESTINATION POINTER 
LDDR 7;MQVE TWO BYTES OF DATA 


The block move instructions become more useful as the number of bytes to be moved 
increases. 
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3. Move ten bytes of data from memory locations starting at ADDR1 to memory 
locations starting at ADDR2. 


LD BC, 10 ;NUMBER OF BYTES TQ MOVE = 10 
LO DE,ADDRI sINITIALTIZE SQURCE POINTER 

LD HL,ADDR2 ;INITIALIZE DESTINATION POINTER 
LDIR 7;MQVE TEN BYTES QF DATA 


or 


LD BC, 10 ;NUMBER OF BYTES TO MOVE = 10 
LD DE,ADDRi+? ; INITIALIZE SQURCE POINTER 

LO HL,ADDR2+9 -; INITIALIZE DESTINATION POINTER 
LDDR 7;MOQVE TEN BYTES OF DATA 


4. Examine memory locations starting at ADDR until one is encountered that 
contains 0 or until 256 bytes have been examined. 


LD BC, 100H 7>MAXIMUM LENGTH = 100 HEX = 256 
LD HL, ADDR POINT TQ START QF SEARCH AREA 
SUB A 7;GET ZERO FOR COMPARISON 

CPIR 


The final value of the Zero flag indicates why the program exited. 


Zero flag = 1 if the program found a 0 in memory. 
Zero flag = 0 if the program decremented BC to 0. 


The block move and block compare instructions are convenient, but their forms are 
restricted and their applications are limited. The programmer must remember the 
following: 


- BC always serves as the counter; it is decremented after each iteration. The 
Parity / Overflow flag (not the Zero flag) indicates whether BC has been decremented 
to 0. Be careful —the P/ V flag is set to 0 if BC has been decremented to 0; the polarity 
is opposite of that used with the Zero flag. Thus, after a block move or block compare, 
the relevant conditional branches have the following meanings: 


JP PE means “branch if BC has not been decremented to 0.” 
JP PO means “branch if BC has been decremented to 0.” 
- HL always serves as the source pointer in block moves and as the memory pointer 


in block compares. HL is incremented or decremented after the data is transferred ora 
comparison is performed. 


- DEalways serves as the destination pointer in block moves; it is not used in block 
compares. Like HL, DE is incremented or decremented after the data is transferred. 
Note also that LDI and LDIR increment both HL and DE, while LDD and LDDR 
decrement both pairs. 
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- Repeated block comparisons exit if either a true comparison occurs or BC is 
decremented to 0. Testing the Zero flag will determine which condition caused the exit. 


TABLE LOOKUP 


Although the Z80 processor has indexing, the calculations required for table lookup 
must be performed explicitly using the ADD HL or ADD xy instruction. This is 
because the Z80’s indexing assumes a variable 16-bit address in an index register and a 
fixed 8-bit offset. As with array manipulation, table lookup is simple if the table 
consists of 8-bit data items; it is more complicated if the table contains longer items or 
addresses. The instructions EX DE,HL and JP (HL) or JP (xy) can be useful, but 
require the programmer to place the results in specific 16-bit registers. 


Examples 


1. Load the accumulator with an element from a table. Assume that the base 
address of the table is BASE (a constant) and the 16-bit index is in memory locations 
INDEX and INDEX+1 (MSB in INDEX+1). 


LD DE, BASE ;GET BASE ADDRESS 

LD HL, (INDEX) 7;GET INDEX 

ADD HL, DE 7;CALCULATE ADDRESS OF ELEMENT 
LD A, CHL) s;OBTAIN THE ELEMENT 


Reversing the roles of DE and HL would slow down the program since LD 
DE,(ADDR) executes more slowly and occupies more memory than does LD 
HL,(ADDR). This asymmetry is caused by the fact that only LD HL,(ADDR) 1s an 
original 8080 instruction; the direct loads of other register pairs (including the stack 
pointer) are additions to the underlying 8080 instruction set. 


2. Load the accumulator with an element from a table. Assume that the base 
address of the table is BASE (a constant) and the index is in the accumulator. 


LD L,A s;EXTEND INDEX TO 16 BITS IN HL 
LD H,9 

LD DE, BASE 7;GET BASE ADDRESS 

ADD HL, DE 7;CALCULATE ADDRESS OF ELEMENT 
LD A, CHL) s;OBTAIN THE ELEMENT 


3. Load register pair DE with a 16-bit element from a table. Assume that the base 
address of the table is BASE (a constant) and the index is in the accumulator. 
ADD A,A ;DOUBLE INDEX FOR 16-BIT ELEMENTS 


LD LA sEXTEND INDEX TO 16 BITS 
LD H,90 


CHAPTER 1. GENERAL PROGRAMMING METHODS 39 


LD BC, BASE 7;GET BASE ADDRESS 

ADC HL, BC ?CALCULATE STARTING ADDRESS 
LD E, CHL) 7;GET LSE OF ELEMENT 

INC HL 

LO D, CHL) ;GET MSB OF ELEMENT 


You can also use the instruction ADD HL,HL to double the index; it is slower than 
ADD A,A but it automatically handles cases in which the doubled index is too large 
for 8 bits. 


4. Transfer control (jump) to a 16-bit address obtained from a table. Assume that 
the base address of the table is BASE (a constant) and the index 1s in the accumulator. 


ADD A,A ;DOUBLE INDEX FOR 16-BIT ELEMENTS 
LO LA sEXTEND INDEX TQ 16 BITS 

LD H,9O 

LD BC, BASE ;GET BASE ADDRESS 

ADD HL,RC sCALCULATE STARTING ADDRESS 

LD E, CHL) s;GET LSE OF DESTINATION 

INC HL 

LD D, (HL) s;GET MSB QF DESTINATION 

EX DE, HL 

IP CHL} sJUMP TO DESTINATION 


The common uses of jump tables are to implement CASE statements (multi-way 
branches used in languages such as FORTRAN, Pascal, and PL/I), to decode com- 
mands from a keyboard, and to respond to function keys on a terminal. 


CHARACTER MANIPULATION 


The easiest way to manipulate characters on the Z80 processor is to treat them as 
unsigned 8-bit numbers. The letters and digits form ordered subsequences of the 
ASCII character set (for example, the ASCII version of the letter A is one less than the 
ASCII version of B). Appendix C contains a complete ASCII character set. 


Examples 


1. Branch to address DEST if the accumulator contains ASCII E. 


CP ee 71S DATA ASCII E? 
JR Z,DEST 7;YES, BRANCH 


2. Search a string starting at address STRNG until a non-blank character is found. 


LD HL,STRNG ;POINT TO START OF STRING 
EXAMC: LD A, CHL) 7;GET NEXT CHARACTER 

CP < 71S IT A BLANK? 

JR NZ, DONE 7;NO, DONE 
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INC HL 7;YES, PROCEED TO NEXT CHARACTER 
JP EXAMC 
DONE: NOP 


or 


LD HL,STRNG-1 ;POQINT To BYTE BEFORE STRING 
EXAMC: INC HL 
LD A, CHL) 7;GET NEXT CHARACTER 
cP oo 71S IT A BLANK? 
WIR Z,EXAMC 7YES, KEEP LOOKING 

We could make either version execute faster by placing the blank character in a 
general-purpose register (for example, register C) and comparing each character with 
that register (using CP C) rather than with an immediate data value. 

We could also use the block compare instructions which combine the comparison 
and the incrementing of the pointer in HL. The CPI instruction, for example, not only 
compares the accumulator with the data at the address in HL, but also increments HL 
and decrements BC. Thus, the program using CPI is 

LD HL,STRNG ;POINT TO START OF STRING 
LD A," ° 7GET A BLANK FOR COMPARIS(N 


EXAMC: CPI 7IS NEXT CHARACTER A BLANE? 
JR Z,EXAMC 7YES, KEEP LOOKING 


The CPI instruction sets the Zero flag to | if the operands being compared are equal 
and to 0 if they are not equal. It also sets the Parity / Overflow flag to 0 if it decrements 
BC to 0 and to | if it does not, thus allowing the programmer to check easily for the 
termination of the string as well as for a true comparison. We cannot use CPIR here, 
since it would terminate as soon as a blank character (rather than a non-blank 
character) was found. - 


3. Branch to address DEST if the accumulator contains a letter between C and F, 
inclusive. 


CP os ies 71S DATA BELOW C? 

JR C, DONE 7;YES, DONE 

CP “G" 715 DATA BELOW G? 

uJIR C, DEST 7;YES, MUST BE BETWEEN C AND F 
DONE : NOP 


We have taken advantage of the fact that G follows F numerically in ASCII, just 
as it does in the alphabet. Chapter 8 contains further examples of string manipulation. 


CODE CONVERSION 


You can convert data from one code to another using arithmetic or logical opera- 
tions (if the relationship is simple) or lookup tables (if the relationship is complex). 
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Examples 
I. Convert an ASCII digit to its binary-coded decimal (BCD) equivalent. 
SUB “O”" s;CONVERT ASCII Ta BCD 


Since the ASCII digits form an ordered subsequence of the code, all that must be done 
is subtract the offset (ASCII 0). 
You can also clear bits 4 and 5 with the instruction 


AND 1L1001111B ;CONVERT ASCIT TO BCD 
Either the arithmetic instruction or the logical instruction will convert ASCII 0 (3016) 
to decimal 0 (00j¢). 
2. Convert a binary-coded-decimal (BCD) digit to its ASCII equivalent. 
ADDO A,“O° sCQNVERT BCD TQ ASCII 
The inverse conversion is equally simple. Bits 4 and 5 can be set with the instruction 
OR OOLLOQOOB ;CONVERT BCD TQ ASCIT 


Either the arithmetic instruction or the logical instruction will convert decimal 6 (066) 
to ASCII 6 (3646). 


3. Convert one 8-bit code to another using a lookup table. Assume that the lookup 
table starts at address NEWCD and is indexed by the value in the original code (for 
example, the 27th entry is the value in the new code corresponding to 27 in the original 
code). Assume that the data is in memory location CODE. 


LD A, (CODE) ;GET THE OLD CODE 


LD LA 7;EXTEND INDEX TO 16 BITS 

LD H,O 

LD DE,NEWCD ;GET BASE ADDRESS 

ADO HL,DE 7;CALCULATE ADDRESS OF ELEMENT 
LO A, CHL) 7;GET THE ELEMENT 


Indexed addressing cannot be used here, since memory location CODE contains a 
variable value. 


Chapter 4 contains further examples of code conversion. 


MULTIPLE-PRECISION ARITHMETIC 


Multiple-precision arithmetic requires a series of 8-bit operations. They are 


- Clear the Carry flag initially, since there is never a carry into or borrow from the 
least significant byte. 
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- Use the Add with Carry (ADC) or Subtract with Carry (SBC) instruction to 
perform an 8-bit operation and include the carry or borrow from the previous 
operation. 


A typical 64-bit addition program is 


LD B,3 ;NUMBER OF BYTES = 83 

SUB A ;CLEAR CARRY INITIALLY 

LD HL, NUM1 sPOQINT TO START OF NUMBERS 
LD DE, NUM2 


ADDS: LD A, (DE) ;GET A BYTE OF ONE OPERAND 
ADC A, CHL) ;ADD A BYTE OF THE OTHER OPERAND 
LD (HL), A sSTORE THE S-BIT SLIM 
INC DE s;UPDATE POINTERS 
INC HL 
DINZ ADDS ;CQOUNT BYTE OPERATIONS 


Chapter 6 contains further examples. 


MULTIPLICATION AND DIVISION 


There are many ways to implement multiplication. One approach 1s to convert 
multiplication by a small integer into a specific short sequence of additions and left 
shifts. 


Examples 


1. Multiply the contents of the accumulator by 2. 
ADD A,A ;DQUBLE A 


2. Multiply the contents of the accumulator by 5. 


LD B,A 

ADD A,A 3A TIMES 2 
ADD A,A 7A TIMES 4 
ADD A,B 7A TIMES 3 


Both examples assume that no carries ever occur. ADD HL could be similarly used 
to produce a 16-bit result. 

This approach is often handy in accessing elements of two-dimensional arrays. For 
example, assume a set of temperature readings taken at four different positions in each 
of three different storage tanks. Organize the readings as a two-dimensional array 
T(J), where I is the tank number (1, 2, or 3) and J identifies the position in the tank (1, 
2, 3, or 4). Store the reading in the computer’s memory one after another as follows, 
starting with the reading at position | of tank 1: 


BASE Tdi, 1) Reading at tank 1, pesitian Ii 
BASE+1 Tl1,2) Reading at tank 1, position 2 
BASE+2 Td1,3) Reading at tank 1, positian 3 
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BASE+3 TC1,4) Reading at tank 1, position 4 
BASE+4 T¢(2,1) Reading at tank 2, position Il 
BASE +5 T(2,2) Reading at tank 2, positian 2 
BASE+6 Tt2,3) Reading at tank 2, position 3 
BASE+7 T(2, 4) Reading at tank 2, position 4 
BASE+8 T¢3,1) Reading at tank 3, positian 1 
BASE+9 T(3,2) Reading at tank 3, position 2 
BASE+10 T¢3,3) Reading at tank 3, positian 3 
BASE+1 1 T¢(3, 4) Reading at tank 3, positian 4 


Generally, the reading T(I,J) is located at address BASE + 4 * (I-1) + (J—1). If lis in 
the accumulator and J is in register B, the accumulator can be loaded with T(I,J) as 
follows: 


DEC A ;OFFSET FOR TANK I 

ADD A,A 22 % (I-11) 

ADD A,A 74 ® (I-1) 

ADD A,B 7ADD QFFSET FOR POSITION J 
DEC A 74 8% (I-11) + Ct-1) 

LD LA ,;EXTEND INDEX TO 1464 BITS 

LD H,O 

LO DE, BASE 7;GET BASE ADDRESS OF READINGS 
ADD HL, DE 7;ACCESS DESIRED READING 

LD A, CHL) 7;FETCH TCT, 0) 


Extending this approach to handle arrays with more dimensions is shown in 
Chapter 5. 
Division by a power of 2 can be implemented as a series of right logical shifts. 


Example 


Divide the contents of the accumulator by 4. 


SRL OA 7;DIVIDE A BY 2 
SRL OA 7AND THEN BY 2 AGAIN 
Ol 
RRA sDIVIDE A BY 4 BY ROTATING IT TWICE 
RRA 
AND OOLLLL11B ;MAKE SHIFTS LOGICAL BY CLEARING MSEB°S 


The second alternative uses the one-byte instruction RRA, rather than the two-byte 
instruction SRL A. When multiplying or dividing signed numbers, be careful to 
separate the signs from the magnitudes. Replace logical shifts with arithmetic shifts 
that preserve the value of the sign bit. 

Other approaches to multiplication and division include algorithms involving shifts 
and additions (multiplication) or shifts and subtractions (division) as described in 
Chapter 6, and lookup tables as discussed previously in this chapter. 
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LIST PROCESSING 


Additional information on the following material can be found in an article by K.S. 
Shankar published in JEEE Computer. '® 

Lists can be processed like arrays if the elements are stored in consecutive addresses. 
If the elements are queued or chained, however, the limitations of the instruction set 
are evident because 


- Indexed addressing allows only an 8-bit fixed offset. 
- No indirect addressing is available, except through register pairs or index registers. 
- Addresses in register pairs or index registers can be used only to retrieve or store 
8-bit data. 
Examples 


1. Retrieve an address stored starting at the address in register pair HL. Place the 
retrieved address in HL. 


LD E, CHL) 7;GET LSB OF LINK 

INC HL 

LD D, CHL) 7;GET MSB OF LINK 

EX DE, HL 7;REPLACE CURRENT POINTER WITH LINK 


This procedure allows you to move from one element to another in a linked list. 


2. Retrieve data from the address currently in memory locations INDIR and 
INDIR-+ 1 and increase that address by 1. 
LD HL, CINDIR);GET POINTER FROM MEMORY 
LD A, CHL) ;GET DATA USING POINTER 
INC HL. s;UPDATE POINTER BY 1 
LD CINDIR), HL 
This procedure allows the use of the address in memory as a pointer to the next 
available location in a buffer. 


3. Store an address from DE starting at the address currently in register pair HL. 
Increment HL by 2. 


LD (HL),E ;STORE LSB OF POINTER 


INC HL 
LO CHL),D *STQRE MSE OF POINTER 
INC HL sCOMPLETE UPDATING OF HL 


This procedure allows building a list of addresses. Such a list could be used, for 
example, to write threaded code in which each routine concludes by transferring 
control to its successor. The list could also contain the starting addresses of a series of 
test procedures or tasks or the addresses of memory locations or I/O devices assigned 
by the operator to particular functions. 
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GENERAL DATA STRUCTURES 


Additional information on the following material can be found in the book Data 
Structures Using Pascal by A. Tenenbaum and M. Augenstein.!! There are several 
versions of this book by the same authors for different languages and computers. 

More general data structures can be handled using the procedures for array manipu- 
lation, table lookup, and list processing that have been described earlier. The key 
limitations in the instruction set are the same ones mentioned in the discussion of list 
processing. 


Examples 


1. Queues or linked lists. Assume there is a queue header consisting of the base 
address of the first element in memory locations HEAD and HEAD-+1. If there are no 
elements in the queue, HEAD and HEAD+ 1 both contain 0. The first two locations in 
each element contain the base address of the next element or 0 if there is no next 
element. 


- Add an element to the head of the queue. Assume that the element’s base address 1s 
in DE. 


LD HL, HEAD s;REPLACE HEAD, SAVING OLD VALUE 


LD A, CHL) ;MOVE LESS SIGNIFICANT BYTES 

LD (HL),E 

INC HL 

LD B, CHL) ?7MOVE MORE SIGNIFICANT BYTES 

LO (HL), D 

LD (DE),A NEW HEAD POINTS TO OLD HEAD 

LO A,B s INCLUDING MORE SIGNIFICANT BYTES 
INC DE 


LD (DE),A 


- Remove an element from the head of the queue and set the Zero flag if no element 
is available. Place the base address of the element (or 0 if there is no element) in DE. 


LO HL ,HEAD sQBTAIN HEAD OF GUEVIE 
LD E, CHL) s;LESS SIGNIFICANT BYTE 
INC HL 
LO D, CHL) MORE SIGNIFICANT BYTE 
LD 4,0 
QR E ;ANY ELEMENTS IN QUEUE? 
JR Z, DONE ;NOQ, DONE 
INC DE 7YES, MAKE NEXT ELEMENT NEW HEAD 
LD A, (DE) 
LO CHLI,A ;MORE SIGNIFICANT BYTE 
DEC DE 
DEC HL 
LD (DE),A 7;LESS SIGNIFICANT BYTE 
LO (HLI,A 

DONE: NOP 
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Since no instruction after OR E affects any flags, the final value of the Zero flag 
indicates whether the queue was empty. 


2. Stacks. Assume there is a stack structure consisting of 8-bit elements. The 
address of the next empty location is in addresses SPTR and SPTR+1. The lowest 
address that the stack can occupy is LOW and the highest address is HIGH. Note that 
this software stack grows up in memory (toward higher addresses), whereas the Z80’s 
hardware stack grows down (toward lower addresses). 


- If the stack overflows, set the Carry flag and exit. Otherwise, store the accumula- 
tor in the stack and increase the stack pointer by 1. Overflow means that the stack has 
expanded beyond its assigned area. 


LD HL, (SPTR) ;GET THE STACK POINTER 
EX DE, HL 
LD HL, -CHIGH+1) s;CHECK FOR STACK OVERFLOW 
ADD HL,DE ;SET CARRY IF STACK OVERFLOWS 
IR C, DONE sAND EXIT ON OVERFLOW 
EX DE, HL ;GET STACK POINTER BACK 
Lo CHLD,A ;STORE ACCUMULATOR IN STACK 
INC HL sUPDATE STACK POINTER 
LD (SPTR),HL 
DONE: NOP 


- If the stack underflows, set the Carry flag and exit. Otherwise, decrease the stack 
pointer by 1 and load the accumulator from the stack. Underflow means that an 
attempt has been made to remove data from an empty stack. 


LO HL, (SPTR) GET THE STACK POINTER 
EX DE, HL 
LD HL, -(LOW+1 ) ;CHECK FOR STACK UNDERFLOW 
ADD HL,DE ;CLEAR CARRY IF STACK UNDERFLOWS 
JR NC, DONE s;AND EXIT ON UNDERFLOW 
EX DE, HL s;GET STACK POINTER BACK 
DEC HL sUPDATE STACK POINTER 
LO A, CHL) sLOAD ACCUMULATOR FROM STACK 
LD (SPTR),HL ;RESTORE STACK POINTER 
DONE: CCF 7SET CARRY ON UNDERFLOW 


Both example programs utilize the fact that ADD HL affects only the Carry flag. 
Remember, ADD HL does not affect the Zero flag. Note also that DEC rp and INC rp 
do not affect any flags. 


PARAMETER PASSING TECHNIQUES 


The most common ways to pass parameters on the Z80 microprocessor are 


1. In registers. Seven 8-bit primary user registers (A, B, C, D, E, H, and L) are 
available, and the three register pairs (BC, DE, and HL) and two index registers (IX 
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and IY) may be used readily to pass addresses. This approach is adequate in simple 
cases, but it lacks generality and can handle only a limited number of parameters. The 
programmer must remember the normal uses of the registers in assigning parameters. 
In other words, 


- The accumulator is the obvious place to put a single 8-bit parameter. 


- Register pair HL is the obvious place to put a single address-length (16-bit) 
parameter. 


- Register pair DE is a better place to put a second address-length parameter than 
register pair BC, because of the EX DE,HL instruction. 


- An index register (IX or IY) is the obvious place to put the base address of a data 
structure when elements are available at fixed offsets. 


This approach 1s reentrant as long as the interrupt service routines save and restore 
all the registers. 


2. In an assigned area of memory. There are two ways to implement this approach. 
One is to place the base address of the assigned area in an index register. Then 
particular parameters may be accessed with fixed offsets. The problem here is that the 
Z80’s indexing is extremely time-consuming. An alternative is to place the base 
address in HL. Then parameters must be retrieved in consecutive order, one byte at a 
time. 

In either alternative, the calling routine must store the parameters in memory and 
load the starting address into the index register or HL before transferring control to 
the subroutine. This approach is general and can handle any number of parameters, 
but it requires a lot of management. If different areas of memory are assigned for each 
call or each routine, a unique stack is essentially created. Ifa common area of memory 
is used, reentrancy is lost. In this method, the programmer is responsible for assigning 
areas of memory, avoiding interference between routines, and saving and restoring the 
pointers required to resume routines after subroutine calls or interrupts. 


3. In program memory immediately following the subroutine call. If this approach 
is used, remember the following: 


- The base address of the memory area is at the top of the stack; that is, the base 
address is the normal return address, the location of the instruction immediately 
following the call. The base address can be moved to an index register by popping the 
stack with 


POP xy 7;RETRIEVE BASE ADDRESS QF PARAMETERS 


Now access the parameters with fixed offsets from the index register. For example, 
the accumulator can be loaded with the first parameter by using the instruction 


LD A,(xytO)  ;MOVE FIRST PARAMETER TOC A 
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- All parameters must be fixed for a given call, since the program memory is 
typically read-only. 


- The subroutine must calculate the actual return address (the address immediately 
following the parameter area) and place it on top of the stack before executing a RET 
instruction. 


Example 


Assume that subroutine SUBR requires an 8-bit parameter and a 16-bit parameter. 
Show a main program that calls SUBR and contains the required parameters. Also 
show the initial part of the subroutine that retrieves the parameters, storing the 8-bit 
item in the accumulator and the 16-bit item in register pair HL, and places the correct 
return address at the top of the stack. 


Subroutine call 


CALL SUBR s;EXECUTE SUBROUTINE 
DEFB PARS 78-BIT PARAMETER 
DEFW PARIG4 716-BIT PARAMETER 


ee next instruction ... 


Subroutine 
SUBR: FOP xy *POINT Ta START QF PARAMETER AREA 

LO A, (xytid :GET LSB OF 146-BIT PARAMETER 
LD E,A 
LQ A, (xyt+2) *GET MSB OF 16-BIT PARAMETER 
LD 0,A 
LD A, (xytO) sGET S-BIT PARAMETER 
Lo BC,3 *UPDATE RETURN ADDRESS 
ADD xy,BC 
PUSH xy 


» « «. remainder of subroutine... 


RET ;RETURN TQ NEXT INSTRUCTION 


The initial POP xy instruction loads the index register with the return address that 
CALL SUBR saved at the top of the stack. In fact, the return address does not contain 
an instruction; instead, it contains the first parameter (PAR8). The next instructions 
move the parameters to their respective registers. Finally, adding 3 to the return 
address and saving the sum in the stack makes the final RET instruction transfer 
control back to the instruction following the parameters. 

This approach allows parameter lists of any length. However, obtaining the parame- 
ters from memory and adjusting the return address is awkward at best; it becomes a 
longer and slower process as the number of parameters increases. 
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4. In the stack. When using this approach, remember the following: 


- CALL stores the return address at the top of the stack. The parameters that the 
calling routine placed in the stack begin at address ssss + 2, where ssss is the contents of 
the stack pointer. The 16-bit return address occupies the top two locations of the stack, 
and the stack pointer itself always refers to the lowest occupied address, not the highest 
empty one. 


- The subroutine can determine the value of the stack pointer (the location of the 
parameters) by (a) storing it in memory with LD(ADDR),SP or (b) using the sequence 


LD HL, oO MOVE STACK POINTER TO HL 
ADO HL, SP 


This sequence places the stack pointer in register pair HL (the opposite of LD SP,HL). 
We can use an index register instead of HL if HL is reserved for other purposes. 


- The calling program must place the parameters in the stack and assign space for 
the results before calling the subroutine. It must also remove the parameters from the 
stack (often referred to as cleaning the stack) afterward. Cleaning the stack is simple if 
the programmer always places the parameters above the empty area assigned to the 
results. Then the parameters can be removed, leaving the results at the top. The next 
example illustrates how this is done. An obvious alternative is for the results to replace 
some or all of the parameters. 


- Stack locations can be allocated dynamically for results with the sequence 


LO HL, -NRESLT ;LEAVE ROOM FOR RESULTS 
ADO HL,SP 
Lo SP, HL 


This sequence leaves NRESLT empty locations at the top of the stack as shown in 
Figure 1-8. Of course, if NRESLT is small, simply executing DEC SP NRESLT times 
will be faster and shorter. The same approaches can be used to provide stack locations 
for temporary storage. 


Example 


Assume that subroutine SUBR requires an 8-bit parameter and a 16-bit parameter, 
and that it produces two 8-bit results. Show a call of SUBR, the placing of the 
parameters in the accumulator and register pair HL, and the cleaning of the stack after 
the return. Figure 1-9 shows the appearance of the stack initially, after the subroutine 
call, and at the end. Using the stack for parameters and results will generally keep the 
parameters at the top of the stack in the proper order. In this case, there is no need to 
save the parameters or assign space in the stack for the results (they will replace some 
or all of the original parameters). However, space must be assigned on the stack for 
temporary storage to maintain generality and reentrancy. 
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Calling program 
LD HL, -2 sLEAVE ROOM ON STACK FOR RESULT 
ADD HL,SP 374 GENERAL WAY TO ADJUST SP 
LO SP, HL 
LD HL, (PARI6);QBTAIN 16-BIT PARAMETER 
PUSH HL sMOVE 1é6-BIT PARAMETER TO STACK 
LO A, (PARS) ;QBTAIN S-BIT PARAMETER 
PUSH AF sMOVE S-BIT PARAMETER TQ STACK 
INC SP sREMOVE EXTRANEQUS BYTE 
CALL SUBR sEXECUTE SUBROUTINE 
LD HL, 3 7;CLEAN PARAMETERS FROM STACK 
Ano HL,SP 
LD SP, HL sRESULT IS NOW AT TOP OF STACE 
Subroutine 
SUBR: LO HL, 2 sFOINT TQ START OF PARAMETER AREA 
ADD HL,S 
LD A, CHL) ;GET S-BIT FARAMETER 
INC HL 
LD E, (HL? ;GET 16-BIT FARAMETER 
ING HL 
LD N, CHL) 
INC HL 
EX DE, HL 


» « « FYeMmainder of subroutine .. . 
RET 
The first three instructions of the calling program could be replaced with two DEC 
SP instructions, and the last three instructions with three INC SP instructions. Note 


that only 16-bit register pairs can be moved to or from the stack. Remember, AF 
consists of the accumulator (MSB) and the flags (LSB). 


ssss - NRESLT 


Empty space 
for storing 
results in the 


stack 
SSSS 


Stack Stack 
Pointer Pointer 


No values are placed in the locations. 
The initial contents of the stack pointer are ssss. 





Figure 4-8. The stack before and after assigning NRESLT empty locations for results 
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the Stack of CALL SUBR the Stack 


address 
MSB of return 
address 


8-bit 
parameter 
LSB of 16-bit 
parameter 
parameter | ee! 
parameter 
Empty byte 
for result #1 Result #1 
Empty byte 
SSSS 
, for result #2 Result #2 


Stack Stack Stack 
Pointer Pointer Pointer 


The initial contents of the stack pointer are ssss. 





Figure 4-9. The effect of a subroutine on the stack 


SIMPLE INPUT/OUTPUT 


Simple input/output can be performed using either 8-bit device (port) addresses or 
full 16-bit memory addresses. The advantages of device addresses are that they are 
short and provide a separate address space for I/O ports. The disadvantages are that 
only a few instructions (IN, OUT, and block I/O instructions) use device addresses. If, 
on the other hand, I/O devices occupy memory addresses, any instruction that 
references memory can also perform I/O. The problems with this approach are that it 
is non-standard, it makes it difficult for a reader to differentiate I/O transfers from 
memory transfers, and it requires that some memory address space be reserved for I/O 
devices. 


Examples 
1. Load the accumulator from input port 2. 
IN A, (2) 7;READ FROM FORT 2 


Or 


LD C,2 ;PUT PORT ADDRESS IN C 
IN A, (C) ;READ FROM PORT 2 
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The second alternative is longer but more flexible. The IN reg,(C) instruction allows 
the data to be obtained from any port and loaded into any register. On the other hand, 
IN A,(port) is limited to loading the accumulator from a fixed port address. The Sign 
and Zero flags can be set by IN reg,(C) for later testing, whereas IN A,(port) does not 
affect the flags. 


2. Load the accumulator from the input port addressed by the contents of memory 
location IPORT. 


LO A, CIPORT) ;GET DEVICE (PORT) ADDRESS 
LO C,A 
IN A, (CO) sREAD DATA FROM INPUT PORT 
The port address can be readily changed (by changing RAM location IPORT) to 
accommodate multiple input devices attached to a single CPU or to handle different 
device addresses used in different models, configurations, or computers. 


3. Load the accumulator from the input port assigned to the memory address in 
HL. 


LD A, CHL) ;READ DATA FROM INPUT PORT 


Here the same input routine can obtain data from any memory address. Of course, 
that memory address is no longer available for normal use, thus reducing the actual 
memory capacity of the computer. 


4. Store the accumulator in output port 6. 


QUT €6),A sWRITE DATA TQ PORT 6 
Or 

LD C,6 s;ACCESS PORT 6 

QUT (C),A sWRITE DATA TQ FORT 6 


In the second alternative, the indirect port address can be changed easily to accom- 
modate a different set of I/O ports or variable I/O devices. 


5. Store the accumulator in the output port addressed by the contents of memory 
location OPORT. . 


LD HL,QPORT ;OQBTAIN PORT ADDRESS 
LD C, CHL) 
OUT <(C),A SEND DATA TO QUTPUT PORT 


Here the port address is a variable. 


6. Store the accumulator in the output port assigned to the memory address in HL. 


LD CHL),A SEND DATA TQ QUTPUT PORT 
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Here the same output routine can send data to any memory address. 


7. Set the Zero flag if bit 5 of port D4j¢ is 0. 


IN A, (OD4H) ;READ DATA FROM PORT 04 
BIT 3,4 7;TEST BIT 3S 


If the bit position to be tested is 0, 6, or 7, a shift or AND A instruction can be used to 
test it. 


8. Load the Carry flag from bit 7 of the input port assigned to memory address 
33 A516. 


LD A, (33A5H) 7;QBTAIN DATA 
RLA 7MQVE SIGN BIT TQ CARRY 


Or 


LO HL, (33A5H) 
RL. CHL) s;MOVE SIGN BIT OF INPUT DATA TO CARRY 
RL (HL) could have unpredictable side effects, since it will attempt to store its result 
back in the input port. Although the port is addressed as a memory location, it may not 
be writable (that is, it might act like a ROM location). For example, it could be 
attached to a set of switches that the microprocessor obviously cannot change. 


9. Set bit 5 of output port A546. 


LD A, 001000008 7SET BIT 3 TO l 
QUT COASH),A 7;MOVE THE BIT TO FORT AS 


To leave the other bits of port A5;¢ unchanged, a copy of the data in RAM is needed. 
Then the following sequence will set bit 5 to 1. 


LD A, (COPY) sGET COPY OF DATA 
SET 5,4 ;SET BIT 3 

QUT COASH),A UPDATE OUTFUT DATA 
LD CCOPY),A sUPDATE COPY OF DATA 


Note that the CPU cannot generally read an output port, and the input port with the 
same device address is not necessarily the same physical location. 


10. Clear bit 3 of the output port assigned to memory address BO070¢. 


LD HL, OBO70H 
RES 3, CHL) ;CLEAR BIT 3 


Even though the output port is addressed as a memory location, it may not be 
readable. If it is not, the overall effect of RES 3,(HL) will be uncertain; the instruction 
will surely clear bit 3, but it will assign the other bits of the port the values supposedly 
obtained by reading from them. These values are generally arbitrary unless the port is 
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latched and buffered. Saving a copy of the data in RAM location TEMP removes the 
uncertainty. Now bit 3 can be cleared with the sequence 


LD HL, TEMP 


RES 3, CHL) 7;SET BIT 3 OF COPY 
LD DE, BO70H 
LOT ;SET BIT 3 OF QUTFUT DATA ALSO 


Block Input and Output Instructions 


The Z80 has special instructions that combine input or output with counting and 
updating of a memory pointer. These so-called block I/O instructions work much like 
the block move and block compare instructions discussed earlier. All block I/O 
instructions move data either from memory to an output port or from an input port to 
memory (without involving the accumulator), update (either increment or decrement) 
the memory pointer in register pair HL, and decrement the counter in register B. Note 
that block I/O instructions use an 8-bit byte counter in register B, whereas block move 
and block compare instructions use a 16-bit counter in BC. In block I/O instructions, 
register C always contains the device address. The only meaningful flag is the Zero 
flag; it is set to | if the instruction decrements B to 0, and to 0 otherwise. 

Repeated block I/O instructions continue transferring data, updating HL, and 
decrementing B until B is decremented to 0. The drawback here is that continuous data 
transfers make sense only if the I/O device operates at the same speed as the processor. 
Obviously, most I/O devices operate much more slowly than the processor, and the 
programmer must introduce a delay between transfers. For example, the processor 
cannot transfer a block of data to or from a keyboard, printer, video display, or 
magnetic tape unit without waiting between characters. Thus, repeated block I/O 
instructions are useful only to transfer data to devices that operate at processor speed, 
such as a buffer memory or a peripheral chip. 

The Z80’s block I/O instructions are the following: 


- INI (IND) moves a byte of data from the port address in C to the memory address 
in HL, increments (decrements) HL, and decrements B. 


- INIR (INDR) repeats INI (IND) until B is decremented to 0. 


- OUTI (OUTD) moves a byte of data from the memory address in HL to the port 
address in C, increments (decrements) HL, and decrements B. 


- OTIR (OTDR) repeats OUTI (OUTD) until B is decremented to 0. 


Note that block I/O instructions reserve B, C, and HL, but not DE. These instruc- 
tions also change all the flags except Carry, although only the Zero flag is meaningful. 
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Examples 


I. Move a byte of data from memory address ADDR to output port OPORT: 


LD B,1 ;NUMBER OF BYTES = 1 

LD C, OPQRT ;PORT ADDRESS = OPORT 

LO HL, ADDR INITIALIZE MEMORY POINTER 
QUTI ;MOVE A BYTE OF DATA 


Obviously, the overhead of loading the registers makes it uneconomical to use OUTI to 
send a single byte of data. 


2. Move two bytes of data from input port IPORT to memory addresses ADDR 
and ADDR+1. Use subroutine DELAY to wait before each transfer; assume that 
DELAY provides the proper time interval without affecting any registers. 


LO B,2 sNUMBER OF BYTES = 2 

LO C, IPOQRT ;PORT ADDRESS = IPORT 

LD HL, ADDR s INITIALIZE MEMORY POINTER 
INBYT: CALL DELAY ;WAIT BEFORE EACH INPUT BYTE 

INI ;READ A BYTE AND UPDATE 


UR NZ, INBYT 


The Zero flag indicates whether the counter in B has been decremented to 0. Not only 
does INI transfer the data directly into memory, but it also increments HL and 
decrements B. 


3. Move ten bytes of data from memory addresses starting with ADDR to output 
port OPORT. Use subroutine DELAY to wait between bytes. 


LD B,10 ;NUMBER OF BYTES = 10 

LD C,QPQRT 7;PORT ADDRESS = OQPORT 

LO HL, ADDR INITIALIZE MEMORY POINTER 
QUTBYT: QUTI s;WRITE A BYTE AND UPDATE 

CALL DELAY ;WAIT BETWEEN BYTES 


JR NZ, OUTBYT 


We cannot use the repeated block output instruction OTIR, since it does not allow a 
delay between bytes. 


4. Move 30 bytes of data from an input buffer addressed through input port IPORT 
to memory addresses starting with ADDR. Assume that the processor can read 
successive bytes of data from the buffer without waiting. 


LD B,30 ;NUMBER OF BYTES = 30 
LD C, TFORT 7;PORT ADDRESS = IPORT 
LD HL, ADDR 7; INITIALIZE MEMORY POINTER 
INIR ;READ A BLOCK OF DATA 


This sequence does not allow any programmed delay between input operations, so it 
makes sense only if the input device operates at the same speed as the processor. 
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LOGICAL AND PHYSICAL DEVICES 


One way to allow references to I/O devices by number is to use an I/O device table. 
An I/O device table assigns the actual I/O addresses (physical devices) to the device 
numbers (logical devices) to which a program refers. A systems program then uses the 
table to convert the device numbers into actual I/O addresses. 

The same applications program can be made to utilize different I/O devices by 
making the appropriate changes in the I/O device table. A program written in a 
high-level language may, for example, refer to input device #2 and output device #5. 
For testing purposes, an operator may assign devices #2 and #5 to be the input and 
output ports, respectively, of his or her console. For normal stand-alone operation, the 
operator may assign device #2 to be an analog input unit and device #5 the system 
_ printer. For operation by remote control, the operator may assign devices #2 and #5 to 
be communications units used for input and output. 

This distinction between logical and physical devices can be implemented by using 
the instructions IN reg,(C) and OUT (C),reg. If a device table starting in address 
IOTBL and consisting of 8-bit device addresses is used, input and output are general- 
ized as follows: 


- Load the accumulator from a fixed device number DNUM. 


LD A, CIQTBL+DNUM) ;GET DEVICE ADDRESS 
LD C,A 
IN A, (C) sQBTAIN DATA FROM DEVICE 


- Load the accumulator from the device number in memory location DEVNO. 


LD A, (DEVNOQ) ;GET DEVICE NUMEER 

LO L,A sMAKE DEVICE NUMBER INTO INDEX 

LD H,O0 

LD DE, IOTBL 7;GET BASE ADDRESS OF DEVICE TABLE 
ADD HL,DE FACCESS ACTUAL DEVICE ADDRESS 

LO C, CHL) 7;OBTAIN DEVICE ADDRESS 

IN A, (C) ;OBTAIN DATA FROM DEVICE 


- Store the accumulator in a fixed device number DNUM. 


LD HL, TOTBL+DNUM ;GET DEVICE ADDRESS 
LD C, CHL) 
QUT <(C),A 7;SEND DATA TO DEVICE 


- Store the accumulator in the device number in memory location DEVNO. 


LD B,A 7;SAVE OUTPUT DATA 

LD A, (DEVNQ) ;GET DEVICE NUMBER 

LD LA 7;MAKE DEVICE NUMBER INTO INDEX 

LD H,O 

Lo DE, IOTBL ;GET BASE ADDRESS OF DEVICE TABLE 
ADD HL, DE F;ACCESS ACTUAL DEVICE ADDRESS 

LO C, CHL) F;QOBTAIN DEVICE ADDRESS 


QUT (C),B ;SEND DATA TO DEVICE 
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In real applications (see Chapter 10), the device table generally contains the starting 
addresses of I/O subroutines (drivers) rather than actual device addresses. 


STATUS AND CONTROL 


Status and control signals can be handled like any other data. The only special 
problem is that the processor cannot ordinarily read output ports. To know the current 
contents of an output port, retain a copy in RAM of the data stored there. 


Examples 


1. Branch to address DEST if bit 3 of input port 6 is 1. 


IN A, (4) ;READ STATUS FROM PORT 6 
BIT 3,A ;TEST BIT 3 
JR NZ, DEST 7BRANCH IF BIT 3 I5 1 


2. Branch to address DEST if bits 4, 5, and 6 of input port STAT are 5 (101 binary). 


IN A, (STAT) ;READ STATUS 

AND 01110000B 7;MASK OFF BITS 4,5, AND 6 
CP 01010000B 31S STATUS FIELD = 3? 

JR Z, DEST 7;YES, BRANCH TO DEST 


3. Set bit 5 of output port CNTL to 1. Assume that a copy of the data is ina table 
starting at address OUTP. 


LD HL, QUTP+CNTL sGET COPY OF DATA 


LD A, CHL) 

QR 00100000B sSET BIT 3 OF PORT 

OUT <CCNTLI,A sSEND DATA TO QUTPUT PORT 
LD CHL), A- s;UPDATE COPY OF DATA 


Update the copy every time the data is changed. 


4. Set bits 2, 3, and 4 of output port CNTL to 6 (110 binary). Assume that a copy of 
the data is in a table starting at address OUTP. 


LD HL, QUTP+CNTL 7;GET COFY OF DATA 


LD A, CHL) 

AND 11100011B ;CLEAR BITS 2,3, AND 4 

OR 0001 1000B 7;SET CONTROL FIELD TQ 6 
QUT <(CNTL),A ;SEND DATA TO OUTPUT PORT 
LD CHLI,A sUPDATE COPY OF DATA 


Retaining copies of the data in memory (or using the values stored in a latched, 
buffered output port) allows changing part of the data without affecting other parts 
that may have unrelated meanings. For example, changing the state of one indicator 
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light (such as a light that indicated remote operation) will not affect other indicator 
lights attached to the same port. Similarly, changing one control line (for example, a 
line that determined whether an object was moving in the positive or negative 
X-direction) would not affect other control lines attached to the same port. 


5. Branch to address DEST if bit 7 of input port IPORT is 0. 


LD C, IPORT ;ESTABLISH PORT ADDRESS 
IN A, (C) sREAD DATA FROM PORT 
JF Z, DEST 7;BRANCH IF INPUT BIT 7 IS 0 


The instruction IN reg,(C) affects the Sign and Zero flags, whereas IN A,(port) does 
not. 


PERIPHERAL CHIPS 


The most common peripheral chips in Z80-based computers are the PIO (Parallel 
Input/Output device), SIO (Serial Input/Output device), and CTC (Clock/ Timer 
Circuit). All these devices can perform many functions, much as the microprocessor 
itself can. Of course, peripheral chips perform fewer different functions than proces- 
sors, and the range of functions is much more limited. The idea behind programmable 
peripheral chips is that each chip contains many useful circuits; the designer selects the 
one he or she wants to use by storing arbitrary codes in control registers, much like 
selecting circuits from a designer’s casebook by specifying arbitrary page numbers or 
other designations. The advantages of programmable chips are that a single board 
containing such devices can handle many applications, and changes or corrections can 
be made by changing selection codes rather than by redesigning circuit boards. The 
disadvantages of programmable chips are the lack of standards and the difficulty of 
learning and explaining how specific chips operate. 

Chapter 10 contains typical initialization routines for the PIO, SIO, and CTC 
devices. (The PIO and CTC are discussed in detail in the Osborne 4 & 8-Bit Micro- 
processor Handbook. ') We will provide only a brief overview of the PIO device here, 
since it is the most widely used. Bas and Kaynak describe a typical industrial applica- 
tion using a PIO.!3 


PIO (Parallel Input/Output Device) 
General Description 


The PIO contains two 8-bit ports, A and B. Each port contains 


- An 8-bit output register. 
- An 8-bit input register. 
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- A 2-bit mode control register, which indicates whether the port is in an output, 
input, bidirectional, or control mode. 


- An8-bit input/output control register, which determines whether the correspond- 
ing data pins are inputs (1) or outputs (0) in the control mode. 


- Two control lines (STB and RDY) that can be used for handshaking signals (the 
contents of the mode control register determine how these lines operate). 


- An interrupt enable bit. 


- A 2-bit mask control register (used only in the control mode) that determines the 
active polarity of the inputs and whether they will be logically ANDed or ORed to 
form an interrupt signal. 


- An 68-bit mask register (used only in the control mode) that determines which port 
lines will be monitored to form the interrupt signal. 


- An 8-bit vector address register used with the interrupt system. 


Here, the important points are the input and output registers, the mode control 
register, the input/output control register, and the control lines. The interrupt-related 
features of the PIO are discussed in Z80 Assembly Language Programming. "4 

The meanings of the bits in the various control and mask registers are related to the 
underlying hardware and are entirely arbitrary as far as the programmer is concerned. 
Tables are provided here and in Appendix B for looking them up. 

Each PIO occupies four input port addresses and four output port addresses. The 
B/A SEL (Port B or A select) and C/ D SEL (Control or Data select) lines choose one 
of the four ports as described in Table 1-10. Most often, designers attach address line 
Ag to B/ A SEL and A, to C/D SEL. The PIO then occupies the four consecutive port 
addresses given in the last column of Table 1-10. 

Clearly, there are far more internal control registers than there are port addresses 
available. In fact, all the control registers for each port occupy one address determined 


Table 4-40. PIO Addresses 


Control or Port Bor A 
Data select Select 







Register Port Address (Starting 
Addressed with PIOADD) 


PIOADD 
PIOADD+1 
PIOADD+2 
PIOADD+3 









Data Register A 
Data Register B 
Control A 
Control B 













The port addresses assume that C/D SEL is tied to A, and B/ A SEL to Ap. 
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Table 4-44. Addressing of PIO Control Registers 


Mode Control D, a D, = D, = Do = | 
Input/Output Control Next byte after port placed in mode 3 
Mask Control Register D3; = 0, D.) = D; = Dp = 1 





Interrupt Mask Register Next byte after mask control register accessed with D,= 1 
Interrupt Enable D3; = D,=0, D; = Dp = 1 
Interrupt Vector Do = | 


by the C/D SEL connection. Thus, some of the data bits sent to a control register are 
actually used for addressing. Note the following situations (see Table 1-11): 


- If Do = 0, the remaining data bits are loaded into the interrupt vector register. 


- If D3;=0and D»= D; = Do= 1, the remaining data bits are loaded into the mask 
control register. If Dg = 1, the next control byte is loaded into the interrupt mask 
register. Interrupts can be enabled (D7 = 1) or disabled (D7 = 0) with D3 = D2 = 0, 
D, = Do =]. 


- If D3, D2, Dj, and Dg are all 1’s, the remaining data bits are loaded into the mode 
control register. If D7= Dg= | (that is, the port has been placed in the control mode), 
the next control byte is loaded into the input/output control register. 


This sharing of an external address means 


- The programmer must be careful to specify the proper addresses, data values, and 
order of operations. The actual destination of an OUT instruction directed to a PIO 
control address depends on the data value and may also depend on the OUT instruc- 
tion that preceded it. 


- The programmer should document the PIO initialization in detail. The device is 
complex, and a reader cannot be expected to understand the initializing sequence. 


The control registers of the PIO are usually initialized only in an overall startup 
routine. Other routines typically refer only to the PIO input and output registers. Since 
all of its control registers share a port address, a repeated block output instruction 
(OTIR or OTDR) can be used to initialize a PIO. No timing problem occurs, since the 
PIO operates at the same speed as the CPU. Chapter 10 contains an example showing 
the use of repeated block output instructions to initialize PIOs and other peripheral 
chips. 
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PIO Operating Modes 


A startup program selects the operating mode of a PIO port by writing a control 
byte to the PIO in the form shown in Figure 1-10. The lower table in Figure 1-10 
describes the operating modes and their associated control bytes. Note that only bits 6 
(Mo) and 7 (M)) affect the operating mode; bits 4 and 5 are not used and bits 0 through 
3 are used for addressing. When power is turned on, the PIO comes up in mode | 
(input). The modes may be summarized as follows: 


- Mode 0 — Output (bit 7 = bit 6 = 0) 

Writing data into the port’s output register latches the data and causes it to appear 
on the port’s data bus. The Ready (RDY) line goes high to indicate Data Ready; it 
remains high until the peripheral sends a rising edge (a 0-to-1 or low-to-high transition) 
on the Strobe (STB) line to indicate Data Accepted or Device Ready. The rising edge 
of STB causes an interrupt if the interrupt is enabled. 


- Mode 1 —Input (bit 7 = 0, bit 6 = 1) 

The peripheral latches data into the port’s input register using the Strobe signal. The 
rising edge of STB causes an interrupt (if enabled) and deactivates RDY (makes it 0). 
When the CPU reads the data, RDY goes high to indicate Data Accepted or Input 
Register Empty. Note that the peripheral can strobe data into the register regardless of 
the state of RDY. The programmer is therefore responsible for guarding against 
overrun (new data being placed in the register before the CPU has read the old data). 


Set Mode 


Sup mpl ppp 
Input 


Bidirectional 

Bit Control If a port is placed in mode 3. the 
next byte sets the I/O control 
register: 


m0 | saan Some Be 
Mod 


ex) 
Output 00001111 OF 
Input 01001111 I/O= 1 Sets bit to Input 


Bidirectional 10001111 1/O = 0 Sets bit to Output 
Control 11001111 


Note that bits 4 and 5 are not used and could have 
any values. 





Figure 1-40. Mode control for the Z80 PIO 
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- Mode 2 — Bidirectional (bit 7 = 1, bit 6 = 0) 

Since this mode uses all four handshake lines, it is allowed only on port A. The port 
A RDY and STB signals are used for output control and the port B RDY and STB 
signals are used for input control. The only difference between this mode and a 
combination of modes 0 and | is that data from the port A Output register is enabled 
onto the port’s data bus only when A STB is active. This allows the port A bus to be 
used bidirectionally under the control of A STB (Output Data Request) and B STB 
(Input Data Available). Note that operations on input register A govern port B’s 
control signals in this mode. 


- Mode 3 — Control (bit 7 = 1, bit 6 = 1) 

This mode does not use the RDY and STB signals. It is intended for status and 
control applications in which each bit has an individual meaning. When mode 3 is 
selected, the next control byte sent to the PIO defines the directions of the port’s bus 
lines. A 1 in a bit position makes the corresponding bus line an input, whereas a 0 
makes it an output. 

Note the following features of the PIO’s operating modes: 


- In modes 0, 1, and 2, the peripheral indicates Data Ready, Device Ready, or Data 
Accepted with a rising edge on the STB line. This edge also causes an interrupt if the 
interrupt is enabled. 


- Inmodes 0, 1, and 2, the PIO indicates Data Ready, Input Buffer Empty, or Data 
Accepted by sending RDY high. This signal remains high until the next rising edge on 
STB. 


- The bidirectional mode (mode 2) applies only to port A, and port B must be placed 
in mode 3 (control) since all the handshaking lines are already committed. 


- The input/output control register is used only in the control mode (mode 3). 
Otherwise, the entire 8-bit port is used for either input or output. 

- There is no way for the processor to determine if a pulse has occurred on STB if 
interrupts are not being used. The PIO is designed for use in interrupt-driven systems 
rather than in programmed I/O systems. STB should be tied low if it is not being used. 


- The processor cannot control the R DY lines directly. The R DY line on a port goes 
high when data is transferred to or from the port and goes low on the rising edge of 
STB. 


- The contents of the output register can be read if the port is in the output or 
bidirectional mode. If the port is in the control mode, the output register data from the 
lines assigned as outputs can be read. The contents of control registers cannot be read. 
If a program needs to know their contents, it must save copies in RAM of the values 
stored there. 

- Ifthe RDY output is tied to the STB input ona port in the output mode, RDY will 
go high for one clock period after each output operation. This brief pulse can be used 
to multiplex displays. 
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PIO Initialization 


When power is turned on, the PIO comes up in the input mode with all interrupts 
disabled and inhibited and control signals deactivated (low). The steps in initializing a 
PIO port are 


- Select the operating mode by writing the appropriate control byte into the mode 
control register. Interrupt control as well as I/O mode information may have to be 
sent. 


- Ifin mode 3, establish the directions of the I/O pins by writing a control byte into 
the input/output control register. This byte must follow the control byte that selected 
mode 3. 


Examples 
1. Make port B output. 


LD A, QOOOLLIIB 7MAKE PORT B QUTPUT 
QUT <C(PIOCRB),A 


Bits 0 through 3 of the control byte are all 1’s to address the mode control register. Bits 
6 and 7 are both 0’s to put the port in the output mode. Bits 4 and 5 are not used. 


2. Make port A input. 
LO A,Q1001111B ;MAKE FORT A INPLIT 
QUT CFIOQCRA),A 


Bit 7 = 0 and bit 6= | to put the port in the input mode. 


3. Make port A bidirectional. 


Lo A, LOO001111B ;MARE PORT A BIDIRECTIONAL 
QUT <CPIOQCRA),A 


Bit 7= 1 and bit 6= 0 to put the port in the bidirectional mode. Remember that only 
port A can be operated in the bidirectional mode, and that port B must then be 
operated in the control mode. 


4. Make port A control with all lines inputs. 


LD A, 11001111B s;MAKE PORT A CONTROL 
QUT CPTIOCRA),A 

LD A, LALILLILIB 7;ALL BITS INPUTS 

QUT <CPIOCRA),A 


The first OUT instruction puts port A in the control mode, since bits 6 and 7 are both 
1. The second OUT operation to the same address loads a different register (the 
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input/output control register). A 0 in a bit position of that register makes the 
corresponding pin an output, while a | makes it an input. The polarity here is arbitrary, 
and many bidirectional devices use the opposite convention. 


5. Make port B control with all lines outputs. 


LD A,11001111B ;MAKE PORT B CONTROL 
QUT (PIOCRB),A 

SUB A ALL BITS QUTPUTS 
QUT (PIOCRB),A 


The second byte is directed automatically to the input/output control register if the 
first byte puts the port in the control mode. 


6. Make port A control with lines 1, 5, and 6 inputs and lines 0, 2, 3, 4, and 7 
outputs. 
LD A, 110011L11B sMAKE PORT A CONTROL 


QUT (PIOCRA),A 
LD A,01100010B :1,5,6 IN--0,2,3,4,7 OUT 


INTERRUPT SERVICE ROUTINES 


More information on material in this section can be found in the book Practical 
Microcomputer Programming: The Z80 by W.J. Weller, Chapter 16. 

Z80 interrupt systems may operate in any of three modes.!> In all three modes, the 
processor responds to an interrupt by executing a CALL or RST instruction which 
transfers control to a specific memory address and saves the current program counter 
at the top of the stack. Table 1-12 lists the destination addresses for the RST instruc- 
tions and the non-maskable interrupt. No other registers (besides the program coun- 
ter) are saved automatically. 

There are two common approaches to saving registers: 


- If there is only a single level of interrupts, primary registers may be saved in the 
alternate set. The service routine begins with 


EX AF, AF“ s;SAVE PRIMARY REGISTERS IN ALTERNATES 
EXX 


The EXX instruction exchanges registers B, C, D, E, H, and L with their primed 
equivalents. The service routine must end by restoring the original primary registers 
with 
EXX RESTORE ORIGINAL PRIMARY REGISTERS 
EX AF, AF ~ 


This approach assumes that the alternate (primed) registers are reserved for use in 
interrupt service routines. 
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Table 1-42. Destination Addresses for RST (Restart) Instructions and 
the Non-Maskable Interrupt 


: Destination Address 
RST Instruction Operation Code 


(Hex) (Decimal) 


RST 0 
RST 8 
RST 10H 


RST 18H 
RST 20H 


RST 28H 
RST 30H 
RST 38H 


Non-maskable 
interrupt 





- If there are several levels of interrupts, each service routine must save all registers 
that it uses in the stack. Since the Z80 has so many registers, most programmers keep 
their service routines simple so that they must save only a few registers. Otherwise, the 
overhead involved in servicing interrupts (sometimes called the interrupt latency) 
becomes excessive. A typical sequence for saving the primary registers in the stack is 


PUSH AF ;SAVE REGISTERS 
PUSH EC 
PUSH DE 
PUSH HL 


The opposite sequence restores the primary registers. 


POP HL ;RESTORE REGISTERS 
Por DE 
POP BC 
POF AF 


Interrupts must be reenabled explicitly with EI immediately before the RET instruc- 
tion that terminates the service routine. The EI instruction delays the actual enabling 
of interrupts for one instruction cycle to avoid unnecessary stacking of return ad- 
dresses (that is, an RET instruction can remove the return address from the stack 
before a pending interrupt is recognized). 

You must be careful to save any write-only registers that may have to be restored at 
the end of the routine. For example, the PIO’s control registers are all write-only, and 
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many external priority registers are also write-only. Copies of such registers must be 
saved in RAM and restored from the stack. A typical example is 


PUSH AF ;SAVE REGISTERS 

PUSH EC © 

PUSH DE 

PUSH HL 

LO A, CPRTY) ;SAVE OLD PRIORITY 

PUSH AF 

LD A, NPRTY 7GET NEW PRIORITY 

QUT PPORT s;PLACE IT IN EXTERNAL PRIORITY REGISTER 


LD CPRTYI,A  3SAVE COPY OF NEW PRIGRITY IN RAM 


The restoration procedure must recover the previous priority as well as the original 
contents of the registers. 


POP AF ;RESTORE OLD PRIORITY 

QUT PPORT ;PLACE IT IN EXTERNAL PRIORITY REGISTER 
LD (PRTY),A 3;SAVE COPY OF PRIORITY IN RAM 

POP HL sRESTORE REGISTERS 

POF DE 

POP BC 

POF AF 


To achieve general reentrancy, the stack must be used for all temporary storage 
beyond that provided by the registers. As noted in the discussion of parameter passing, 
space is assigned on the stack (NPARAM bytes) with the sequence 


LD HL, -NPARAM 7;ASSTGN NPARAM EMFTY BYTES 
ADD HL,SP 
LO SP, HL 


Later, of course, the temporary storage area is discarded with the sequence 


LD HL, NFARAM ;REMOVE NPARAM BYTES FROM STACK 
ADD HL,SP 
LO SP, HL 


If NPARAM is small, save execution time and memory by replacing these sequences 
with NPARAM DEC SP or INC SP instructions. Chapter 11 contains examples of 
simple interrupt service routines. 

Interrupt service routines that are based on signals from Z80 peripheral chips (PIOs, 
S1Os, or CTCs) or that utilize the non-maskable input require special terminating 
instructions. These special instructions restore the program counter from the top of 
the stack just like the normal RET: The RETI (return from interrupt) instruction also 
signals the peripheral chips that the service routine has been completed, thus unblock- 
ing lower priority interrupts. The RETN (return from non-maskable interrupt) 
instruction also restores the interrupt enable logic, thus reenabling interrupts if (and 
only if) they were enabled when the non-maskable interrupt occurred. 


CHAPTER 1: GENERAL PROGRAMMING METHODS 67 


MAKING PROGRAMS RUN FASTER 


More information on material in this section can be found in an article by T. Doll- 
hoff, “Microprocessor Software: How to Optimize Timing and Memory Usage. Part 
Four: Techniques for the Zilog Z80,” Digital Design, February 1977, pp. 44-45. 

In general, programs can be made to run substantially faster only by first determin- 
ing where they spend their time. This requires determining which loops (other than 
delay routines) the processor is executing most often. Reducing the execution time of a 
frequently executed loop will have a major effect because of the multiplying factor. It is 
thus critical to determine how often instructions are being executed and to work on 
loops in the order of their frequency of execution. 

Once it is determined which loops the processor executes most frequently, reduce 
their execution time with the following techniques: 


- Eliminate redundant operations. These may include a constant that is being added 
during each iteration or a special case that is being tested repeatedly. Another example 
is a constant value or a memory address that is being fetched from memory each time 
rather than being stored in a register or register pair. 


- Reorganize the loop to reduce the number of jump instructions. You can often 
eliminate branches by changing the initial conditions, inverting the order of opera- 
tions, or combining operations. In particular, you may find it helpful to initialize 
everything one step back, thus making the first iteration the same as all the others. 
Inverting the order of operations can be helpful if numerical comparisons are involved, 
since the equality case may not have to be handled separately. Reorganization may 
also combine condition checking inside the loop with the overall loop control. 


- Use in-line code rather than subroutines. This will save at leasta CALL and RET. 


- Use the stack rather than specific memory addresses for temporary storage. 
Remember that EX HL,(SP) exchanges the top of the stack with register pair HL and 
thus can serve to both restore an old value and save the current one. 


- Assign registers to take maximum advantage of such specialized instructions as 
LD HL,(ADDR); LD (ADDR),HL; EX DE, HL; EX HL,(SP); DJNZ; and the block 
move, compare, and I/O instructions. Thus it is preferable to always use B or BC fora 
counter, HL for an indirect address, and DE for another indirect address if needed. 


- Use the block move, block compare, and block I/O instructions to handle blocks 
of data. These instructions can replace an entire program sequence, since they combine 
counting and updating of pointers with the actual data manipulation or transfer 
operations. Note, in particular, that the block move and block I/O instructions 
transfer data to or from memory without using the accumulator. 


- Use the 16-bit instructions whenever possible to manipulate 16-bit data. These 
instructions are ADC, ADD, DEC, EX, INC, LD, POP, PUSH, and SBC. 
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- Use instructions that operate directly on data in user registers or in memory to 
avoid having to save and restore the accumulator, HL, or an index register. These 
instructions include DEC, EX, INC, LD, POP, PUSH, and the bit manipulation and 
shift instructions. 


- Minimize the use of the index registers, since they always require extra execution 
time and memory. The index registers are generally used only as backups to HL and in 
handling data structures that involve many fixed offsets. 


- Minimize the use of special Z80 instructions that require a 2-byte operation code. 
These always require extra execution time and memory. Examples are BIT, RES, SET, 
SLA, SRA, and SRL, as well as some load instructions such as LD DE,(ADDR), LD 
(ADDR),BC, and LD SP(ADDR). 


- Take advantage of specialized short instructions such as the accumulator shifts 
(RLA, RLCA, RRA, and RRCA) and DJNZ. 


- Use absolute jumps (JP) rather than relative jumps (JR). The absolute jumps take 
less time if a branch actually occurs. 


- Organize sequences of conditional jumps to minimize average execution time. 
Branches that are often taken should come before ones that are seldom taken, for 
example, checking for a result being negative (true 50% of the time if the value is 
random) before checking for it to be zero (true less than 1% of the time if the value is 
random). 


- Test for conditions under which a sequence has no effect and branch around it if 
the conditions hold. This will be profitable if the sequence is long, and it frequently 
does not change the result. A typical example is the propagation of carries through 
higher order bytes. If a carry seldom occurs, it will be faster on the average to test for it 
rather than simply propagate a 0. 


A general way to reduce execution time is to replace long sequences of instructions 
with tables. A single table lookup can perform the same operation as a sequence of 
instructions if there are no special exits or program logic involved. The cost is extra 
memory, but that may be justified if the memory is available. If enough memory is 
available, a lookup table may be a reasonable approach even if many of its entries are 
repetitive—that is, even if many inputs produce the same output. In addition to its 
speed, table lookup is also general, easy to program, and easy to change. 


MAKING PROGRAMS USE LESS MEMORY 


Only by identifying common instruction sequences and replacing those sequences 
with subroutine calls can a program be made to use significantly less memory. The 
result is a single copy of each sequence; the cost is the extra execution time of the 
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CALL and RET instructions. The more instructions placed in subroutines, the more 
memory is saved. Of course, such subroutines are typically not general and may be 
difficult to understand or use. Some sequences may even be available in a monitor or 
other systems program. Then those sequences can be replaced with calls to the systems 
program as long as the return is handled properly. 

Some methods that reduce execution time also reduce memory usage. In particular, 
eliminating redundant operations, reorganizing loops, using the stack, organizing the 
use of registers, using the 16-bit registers, using block instructions and short forms, 
operating directly on memory or registers, and minimizing the use of the index 
registers and special Z80 instructions reduce both memory usage and execution time. 
Of course, using in-line code rather than loops and subroutines reduces execution time 
but increases memory usage. Absolute and relative jumps represent a minor tradeoff 
between memory and execution time; absolute jumps are faster (if a branch occurs) but 
use more memory. 

Lookup tables generally use extra memory but save execution time. Some ways to 
reduce their memory requirements are to eliminate intermediate values and interpo- 
late the results, eliminate redundant values with special tests, and reduce the range of 
input values.!*!7 Often a few prior tests or restrictions will greatly reduce the size of the 
required table. 
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Chapter 2 Implementing 
Additional Instructions and 
Addressing Modes 


This chapter shows how to implement instructions and addressing modes that are 
not included in the Z80 instruction set. Of course, no instruction set can ever include all 
possible combinations. Designers must choose a set based on how many operation 
codes are available, how easily an additional combination could be implemented, and 
how often it would be used. A description of additional instructions and addressing 
modes does not imply that the basic instruction set is incomplete or poorly designed. 

The chapter will concentrate on additional instructions and addressing modes that 
are 


- Obvious parallels to those included in the instruction set. 
- Described in Fischer’s “Microprocessor Assembly Language Standard”. ! 
- Discussed in Volume | of An Introduction to Microcomputers. 


- Implemented on other microprocessors, especially ones that are closely related or 
partly compatible. 3 


This chapter should be of particular interest to those who are familiar with the 
assembly languages of other computers. 


INSTRUCTION SET EXTENSIONS 


In describing extensions to the instruction set, we follow the organization sug- 
gested in the draft standard for IEEE Task P694.4 Instructions are divided into the 
following groups (listed in the order in which they are discussed): arithmetic, logical, 
data transfer, branch, skip, subroutine call, subroutine return, and miscellaneous. 
For each type of instruction, types of operands are discussed in the following order: 
byte (8-bit), word (16-bit), decimal, bit, nibble or digit, and multiple. In describing 
addressing modes, we use the following order: direct, indirect, immediate, indexed, 
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register, autopreincrement, autopostincrement, autopredecrement, autopostdecre- 
ment, indirect preindexed (also called preindexed or indexed indirect), and indirect 
postindexed (also called postindexed or indirect indexed). 


ARITHMETIC INSTRUCTIONS 


This group includes addition, addition with Carry, subtraction, subtraction in 
reverse, subtraction with Carry (borrow), increment, decrement, multiplication, divi- 
sion, comparison, two’s complement (negate), and extension. Instructions that do not 
clearly fall into a particular category are repeated for convenience. 


Addition Instructions (Without Carry) 


1. Add memory location ADDR to accumulator. 


LD HL, ADDR sFOQINT TO DATA 
ADD A, CHL) 3 THEN ADD IT 


2. Add Carry to accumulator. 
ADC A,9 sACC = ACC + CARRY + O 


3. Decimal add Carry to accumulator. 


ADC A,0 sACC = ACC + CARRY + 0 
DAA ; IN DECIMAL 


4. Decimal add VALUE to accumulator. 


ADD A, VALUE sACC = ACC + VALUE 
DAA ; IN DECIMAL 


5. Decimal add register to accumulator. 


ADD A,reg 3;ACC = ACC + REG 
DAA > IN DECIMAL 


6. Add 16-bit number VALI16 to HL. 


LD rp, VAL16 
ADD HL,rp esHL = HL + VALI6 


rp can be either BC or DE. 


7. Add 16-bit number VALI16 to an index register. 


LD rep, VAL16 
ADD xy,rp sXY = XY + VAL1I4 


rp can be either BC or DE. 
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8. Add memory locations ADDR and ADDR+1 (MSB in ADDR+1) to HL. 


LD rp, (ADDR) 
ADD HL,rp 


The 16-bit data is stored in the usual Z80 format with the less significant byte first (at 
the lower address). 


9. Add memory locations ADDR and ADDR+1 (MSB in ADDR+ 1) to an index 
register. 


LD rp, (ADDR) 
ADD xy,rp 


10. Add memory locations ADDR and ADDR+1 (MSBin ADDR+1) to memory 
locations SUM and SUM+1 (MSB in SUM+1). 


LO HL, (SUM) 7GET CURRENT SUM 
LD DE, (ADDR) 7;ADD ELEMENT 

AND HL,DE 

LD (SUM), HL 7; SAVE UPDATED SLIM 


11. Add the 16-bit number VAL16 to memory locations ADDR and ADDR+1 
(MSB in ADDR-+1). 


LD HL, (SUM) 7GET CURRENT SUM 
Lo DE, VAL16 7;ADO ELEMENT 

ADO HL,DE 

LD (SUM) ,HL 7SAVE UPDATED SUM 


Addition Instructions (with Carry) 


1. Add memory location ADDR to accumulator with Carry. 
LD HL, ADDR s;PQINT TQ DATA 
ADC A, CHL) 3; THEN ADD IN DATA 

2. Add Carry to accumulator. 
ADC A,O 3;ACC = ACC + CARRY + O 


3. Decimal add VALUE to accumulator with Carry. 
ADC A,VALUE sACC = ACC + VALUE + CARRY 
DAA > IN DECIMAL 

4. Decimal add register to accumulator with Carry. 


ADC A,reg 7ACC = ACC + REG + CARRY 
DAA >; IN DECIMAL 


74 780 ASSEMBLY LANGUAGE SUBROUTINES 


5. Add 16-bit number VAL16 to HL with Carry. 


LD rp, VAL1S6 
ADC HL,rp 7;HL = HL + VALI6 + CARRY 


6. Add memory locations ADDR and ADDR+1 (MSB in ADDR-+1) to HL with 
Carry. 


LD rp, (ADDR) 
ADC HL,rp 7;HL = HL + (ADDR) + CARRY 


Subtraction Instructions (Without Borrow) 


1. Subtract memory location ADDR from accumulator. 


Lo HL, ADDR 7;POINT TO DATA 
SUB CHL) 7 THEN SUBTRACT IT 


2. Subtract borrow (Carry) from accumulator. 
SBC A,0O ACC = ACC — CARRY 


3. Decimal subtract VALUE from accumulator. 
ACG = ACC - VALUE 


SUB VALUE ? 
DAA 7 IN DECIMAL 


4. Decimal subtract register from accumulator. 


SUB reg sACC = ACC —- REG 
DAA : IN DECIMAL 


Since the Z80 has an Add/ Subtract flag, it can perform decimal subtraction directly. 
On the 8080 and 8085 processors, the programmer must implement decimal subtrac- 
tion as the addition of a negative number. 


5. Subtract register pair from HL. 


AND A 7;CLEAR CARRY 
SBC HL,rp ;SUBTRACT REGISTER PAIR WITH CARRY 


The Z80 has a subtract register pair with Carry instruction, but no plain subtract 
register pair (without Carry). 


6. Subtract 16-bit number VAL16 from HL. 


LD rp, ~VAL16 
ADQ HL,rp 


or 


AND A 7;CLEAR CARRY 
LD rp,VALIS 
SBC HL,rp s;SUBTRACT 146-BIT NUMBER FROM HL 
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rp can be either BC or DE. Carry is an inverted borrow in the first alternative and a true 
borrow in the second. The first alternative is obviously much shorter, particularly since 
SBC HL requires a 2-byte operation code. 


7, Subtract memory locations ADDR and ADDR+1! (MSB in ADDR+1) from 


HL. 
AND A ;CLEAR CARRY 
LD rp, (ADDR) 7 THEN SUBTRACT WITH CARRY 
SBC HL,rp 


There is no subtract register pair (without Carry) instruction. 


Subtraction in Reverse Instructions 


1. Subtract accumulator from VALUE and place difference in accumulator. 


NEG s;NEGATE A 
ADD A, VALUE 7FORM - A + VALLE 
Or 
LD reg,A 7CALCULATE VALUE — ACC 
LD A, VALUE 
SUB reg 


The Carry is an inverted borrow in the first method and a true borrow in the second. 


2. Subtract accumulator from register and place difference in accumulator. 
NEG s;NEGATE A 
ADL A,reg ;FORM ~- A + REG 


The Carry is an inverted borrow; that is, it is 1 if the subtraction does not require a 
borrow. 


3. Decimal subtract accumulator from VALUE and place difference in accumu- 
lator. 


LO reg,A sCALCULATE VALUE - ACC 
LD A, VALUE 

SUE reg 

LIAA 


4. Decimal subtract accumulator from register and place difference in accumulator. 


LQ regl,A sCALCLILATE REG — ACC 
Lo A,reg 
SUB regl 


DAA 7IN DECIMAL 
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Subtraction with Borrow (Carry) Instructions 


1. Subtract memory location ADDR from accumulator with borrow. 
LO HL, ADDR sPOQINT Ta DATA 


SBC A, CHL) THEN SUBTRACT WITH BORROW 
2. Subtract borrow (Carry) from accumulator. 
SBC A,0 7FORM A — BORROW 


3. Decimal subtract inverted borrow from accumulator (Carry = | if no borrow 
was generated, 0 if a borrow was generated). 


ADC A, 99H 7;ADD 99 PLUS CARRY 
DAA 


The final Carry is 1 if the subtraction generates a borrow and 0 if it does not. 


4. Decimal subtract VALUE from accumulator with borrow. 


SBC A, VALUE 7A = A ~ VALUE — BORRCW 
DAA >; IN DECIMAL 


5. Decimal subtract register from accumulator with borrow. 


SBC A,reg 7A = A - REG —- BORROW 
DAA > IN DECIMAL 


6. Subtract 16-bit number VALI16 from HL with borrow. 


LO rp,VAL16 
SBC HL, rp 7;HL = HL ~- VALI46 - BORROW 


Increment Instructions 


1. Increment memory location ADDR. 


LD HL, ADDR 
INC ¢HL) 


2. Increment accumulator, setting the Carry flag if the result is 0. 


ADD A, 1 


Remember that INC does not affect Carry, but it does affect the Zero flag. 
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3. Decimal increment accumulator (add 1 to A in decimal). 


ADD A,1 
DAA 


You cannot use INC, since it does not affect Carry. 


4. Decimal increment register (add | to reg in decimal). 


Lo A,reg 
Ano A,i 
DAA 

LO reg,A 


DAA applies only to the accumulator. 


5. Increment memory locations ADDR and ADDR+1 (MSB in ADDR + 1). 


LD HL, (ADDR) 
INC HL 716-BIT INCREMENT 
LD (ADDR), HL 


Or 
Lo HL, ADDR 
INC CHL) 7 INCREMENT LSB 
AK NZ, DONE 
INC HL 7;ADD CARRY TO MSB 
INC ¢HL) 
DEC HL 

DONE: NOP 


The second alternative leaves ADDR in HL for later use. 


6. Increment register pair, setting the Zero flag if the result is 0. 


INC rp *16-BIT INCREMENT 
LO A,rpl *TEST RESULT FOR ZERQ 
OR rph 


This sequence destroys the old contents of the accumulator and the flags. OR clears 
Carry. 


Decrement Instructions 


1. Decrement memory location ADDR. 


LD HL, ADDR 
DEC CHL») 
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2. Decrement accumulator, setting Carry flag if a borrow is generated. 


SUB 1 


3. Decrement accumulator, setting Carry flag if no borrow is generated. 


ADD A,OFFH 


4. Decimal decrement accumulator (subtract | from A in decimal). 


SUB 1 
LAA 


DEC cannot be used here, since it does not affect Carry. 


5. Decimal decrement register (subtract | from reg in decimal). 


LO A,reg 
SUB 1 

DAA 

LO reg,A 


DAA applies only to the accumulator. 


6. Decrement memory locations ADDR and ADDR+1 (MSB in ADDR+1). 
LD HL, (ADDR) 


DEC HL 716-BIT DECREMENT 
LO (ADDR), HL 


7. Decrement register pair, setting the Zero flag if the result is 0. 


DEC rp :16-BIT DECREMENT 
LO A,rpl sTEST 14-BIT RESULT FOR ZERQ 
QR rph 


This sequence destroys the old contents of the accumulator and changes the other 
flags. OR clears the Carry flag. 


Multiplication Instructions 


1. Multiply accumulator by 2. 
ADD A,A 


2. Multiply accumulator by 3 (using reg for temporary storage). 


LO reg,A sSAVE A 
ADD A,A 32 X A 
ADD A,reg 23 X A 
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3. Multiply accumulator by 4. 


ADD A,A 72 X A 
ADD A,A 74 X A 


We can easily extend cases 1, 2, and 3 to multiplication by other small integers. 


4. Multiply register by 2. 


SLA reg 


5. Multiply register by 4. 


SLA reg ;MLUILTIPLY BY 2 
SLA reg ;AND THEN BY 2 AGAIN 


Since SLA is a 2-byte instruction, it eventually becomes faster to move the data to the 
accumulator and use the 1-byte instruction ADD A, A. 


6. Multiply register pair HL by 2. 
ADD HL,HL 


7. Multiply register pair HL by 3 (using rp for temporary storage). 


Lo rph,H 
LO rpl,b 
ADD WHL,HL s2 X HL 
ADD HL,rp 33 X HL 


Note that you cannot use EX DE,HL here, since it changes HL. 


8. Multiply an index register by 2. 
ADD AY, XY 


9. Multiply memory locations ADDR and ADDR-+1 (MSB in ADDR-+1) by 2. 
LD HL, ADDR 


SLA CHL) ;SHIFT LSB LEFT LOGICALLY 
INC HL 
RL CHL) > THEN ROTATE MSB TO FICK UP CARRY 


or 


LD xy, ADDR 


SLA (xy+0) s;SHIFT LSB LEFT LOGICALLY 
RL Cxytl) 7 THEN ROTATE MSB TO PICK UP CARRY 


Note that you must rotate the more significant byte to pick up the Carry produced by 
shifting the less significant byte. 


80 780 ASSEMBLY LANGUAGE SUBROUTINES 


Division Instructions 


1. Divide accumulator by 2 unsigned. 
SRL A DIVIDE BY 2, CLEARING SIGN 


2. Divide accumulator by 4 unsigned. 


SRL A *;DIVIDE BY 2, CLEARING SIGN 
SRL A 7 THEN BY 2 AGAIN 
Or 
RRA 7;ROTATE A RIGHT TWICE 
RRA 
AND OO01111115 7 THEN CLEAR 2 MSB°S 


Since SRL is a 2-byte instruction, it eventually becomes faster to use the 1-byte 
instruction RRA and clear the more significant bits explicitly at the end. 


3. Divide accumulator by 2 signed. 
SRA A 7DIVIDE BY 2, EXTENDING SIGN 


4. Divide memory locations ADDR and ADDR+1 (MSB in ADDR+1) by 2 
unsigned. 


LD XY, ADIR 
SRL (XY4+1) sSHIFT MSB RIGHT LOGICALLY 
RR CXY¥+0) THEN ROTATE LSB RIGHT 


Rotating the less significant byte picks up the Carry from the more significant byte. 


5. Divide memory locations ADDR and ADDR+1 (MSB in ADDR+1) by 2 
signed. 


LD XY, ADR 
SRA (XY¥+1) s;SHIFT MSB RIGHT ARITHMETICALLY 
RR CXY¥+O) 7 THEN ROTATE LSB RIGHT 


6. Divide register pair by 2 unsigned. 


SRL reh 7;SHIFT MSB RIGHT LOGICALLY 
RR rpl 7 THEN ROTATE LSB RIGHT 


7. Divide register pair by 2 signed. 


SRA rph ;SHIFT MSB RIGHT ARITHMETICALLY 
RR rpl 7 THEN ROTATE LSB RIGHT 
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Comparison Instructions 


1. Compare VALUE with accumulator bit by bit, setting each bit position that is 
different. 


XOR VALUE 
Remember, the EXCLUSIVE OR of two bits is | if and only if the two bits are different. 


2. Compare register with accumulator bit by bit, setting each bit position that is 
different. 
XOR reg 


3. Compare register pairs (rp and HL). Set Carry if rp is larger (unsigned) than HL 
and clear Carry otherwise. 


AND A ;CLEAR CARRY 
SBC HL,rp 


This sequence changes HL. 


4. Compare register pair HL with 16-bit number VALI6. 


LO rp, ~VAL16 sFORM HL —- VAL16 BY ADDING 
Ann HL,rp 
or 
AND A sCLEAR CARRY 
LO rp, VAL16 
SBC HL,rp 


Carry is an inverted borrow after the first alternative and a true borrow after the 
second. Both sequences change HL and rp. 


5. Compare index register with 16-bit number VALI6. Clear Carry if VALI16 is 
greater than index register and set Carry otherwise. 


LO rp, -VAL1646 sFORM INDEX REGISTER —- VAL14 
ADD xy,rp 


Carry is an inverted borrow here, since we are subtracting by adding the two’s 
complement. 


6. Compare register pair with memory locations ADDR and ADDR+1 (MSB in 
ADDR-+ 1). 
AND A 7CLEAR CARRY 
LOD rp, CADDR) ;SUBTRACT REGISTER PAIR 
SBC HL,rp 


Carry is a true borrow. 


82 780 ASSEMBLY LANGUAGE SUBROUTINES 


7. Compare index register with memory locations ADDR and ADDR+1 (MSB in 
ADDR-+ 1). 


PUSH xy sMOVE INDEX REGISTER TO HL 

POP HL 

AND A sCLEAR CARRY 

LO rp, (ADDR) FORM INDEX REGISTER — OQTHER OPERAND 
SBC HL,rp 


The Z80 has no SBC xy instruction. 


8. Compare stack pointer with the 16-bit number VALI6. 


LO HL, *MOVE STACK POINTER TQ HL 
ADD HL,SP 

LD rp,-VAL146 

ADD HL,rp 


Carry is an inverted borrow. 


9. Compare stack pointer with memory locations ADDR and ADDR+1 (MSB in 
ADDR+1). 


LD HL, Oo *MOVE STACK POINTER TO HL 
ADD HL,SP 

LD rp, (ADDR) 

AND A *CLEAR CARRY 

SBC HL,rp sFORM SP — MEMORY 


Carry is a true borrow. 


Two’s Complement (Negate) Instructions 


1. Negate register. 


SUB A sFOQRM O — REG 
SUB reg 
LO reg,A 


OF 


LD A,reg 
| NEG 
LO reg,A 


2. Negate memory location ADDR. 


SUB A 
LO HL, ADDR 
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SUB (HL) 7;FORM O — (MEMORY) 
LD CHL), A 


Or 


LD HL, ADDR 


LD A, CHL) 7;FORM — CADDR) 
NEG 
LD CHLI,A 


3. Negate register pair. 


LO A,rph :16-BIT OQNE’S COMPLEMENT 

CPL 

LO reph,A 

LO A,rpl 

CPL 

LO rpl,A 

INC rp sADD 1 FAR TWO’S COMPLEMENT 
or 

LD HL, O 3;FORM O —- (RP) 

AND A 3;CLEAR CARRY 

SBC HL,rp 


The second sequence leaves the negative in HL; it can then be moved easily to another 
register pair. 


4. Negate memory locations ADDR and ADDR-+1 (MSB in ADDR+1). 


LO HL,O 3;FQRM O —- (CMEMORY) 
LD rp, (ADDR) 

AND A 

SBC HL,rp 

LO CADDR), HL 


5. Nine’s complement accumulator (that is, replace (A) with 99—(A)). 


LO reg,A 
LQ A, 99H 
SUB reg 


No DAA Is necessary, since 99 — (A) is always a valid BCD number if the accumulator 
originally contained a valid BCD number. 


6. Ten’s complement accumulator (that is, replace (A) with 100—(A)). 


NEG 7;FORM O —- ACCUMULATOR 
DAA 7 THEN DECIMAL ADJUST 
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Extend Instructions 


1. Extend accumulator to a 16-bit unsigned number in a register pair. 


LD rpl,A 78-BIT MOVE 
LD rph,oO ;EXTEND & BITS TO 16 BITS 


This procedure allows you to use the value in the accumulator as an index. ADD HL 
or ADD xy will then add the index to the base. 


2. Extend accumulator to a 16-bit signed number in a register pair. 


LD rpl,A 73-BIT MOVE 

ADD A,A ;MOVE SIGN BIT TQ CARRY 

SBC A.A ;SUBTRACT SIGN BIT FROM ZERO 

LD rph,A s;EXTEND S BITS TO 14 BITS SIGNED 


SBC A,A_ produces 00 if Carry is 0 and FF,, if Carry is 1. It thus extends Carry 
across the entire accumulator. 


3. Extend memory location ADDR to a 16-bit signed number in memory locations 
ADDR (LSB) and ADDR-+1 (MSB). 


LD HL, ADDR 7;FETCH NUMBER 

LD A, CHL) 

ADD A,A ;MOVE SIGN TQ CARRY 

SBC A.A ;FORM SIGN BYTE (00 OR FF) 
INC HL s;STORE SIGN BYTE 


LD (HL), A 


4. Extend bit 0 of accumulator across entire accumulator; that is, (A)= 00 if bit0= 
0 and FF j¢ if bit 0 = 1. 


RRA 7;MQVE BIT O TQ CARRY 
SBC A.A ;FORM O - BIT O 
5. Sign function. Replace the value in the accumulator by 00 if it is positive and by 


FF 6 if it is negative. 


ADD A,A 7;MOVE SIGN BIT TQ CARRY 
SBC A.A 7;FORM O — SIGN BIT 
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LOGICAL INSTRUCTIONS 


This group includes logical AND, logical OR, logical EXCLUSIVE OR, logical 
NOT (complement), shift, rotate, and test instructions. Also included are arithmetic 
instructions (such as adding the accumulator to itself) that perform logical functions. 


Logical AND Instructions 


1. Clear bits of accumulator. 


AND MASK ;CLEAR BITS BY MASKING 
MASK has 0’s in the bit positions to be cleared and 1’s in the positions to be left 
unchanged. For example: 

AND 11011011B ;CLEAR BITS 2 AND 5 
Remember, logically AN Ding a bit with | does not affect its value. Since RES can clear 


only one bit at a time, the following sequence would be needed to produce an 
equivalent result: 


A 7;CLEAR BIT 2 
A 3;AND THEN CLEAR BIT 53 


2. Bit test—set the flags as if accumulator had been logically ANDed with a register 
or memory location, but do not change the accumulator. 


LD reg,A 3SAVE ACCUMLILATOR 

LD HL, ADDR 

AND (HL) ;PERFORM LOGICAL AND 
LD A,reg ;RESTORE ACCUMULATOR 


LD does not affect any flags. 


3. Test bits of accumulator. Set the Zero flag to 1 if all the tested bits are 0 and to 0 
otherwise. 


AND MASK ;TEST BITS BY MASKING 


MASK has 1’s in the positions to be tested and 0’s elsewhere. The Zero flag is set to 1 
if all the tested bit positions are 0, and to 0 otherwise. Since the BIT instruction can test 
only one bit position at a time, AND MASK is equivalent to a sequence of BIT 
instructions and conditional jumps. For example: 


AND 010000010B 7;TEST BITS 1 AND 6 FOR ZERO 
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is equivalent to the sequence 


BIT 6,A ;TEST BIT 6 FOR ZERO 

JR NZ, DONE ;BRANCH IF IT IS NOT ZERO 

BIT 1,4 3THEN TEST BIT 1 FOR ZERQ 
DONE: NOP 


4. Logical AND immediate with flags (condition codes). Logically AND a byte of 
immediate data with the Flag register, clearing those flags that are logically ANDed 
with 0’s. 

PUSH AF *MOVE AF TO A REGISTER PAIR 
FOF rp 

LD A, MASK sCLEAR FLAGS 

AND rpl 

LO rpl,A 


PUSH rp ;RESTORE AF WITH FLAGS CLEARED 
POP AF 


This sequence changes a register pair (BC, DE, or HL). 


Logical OR Instructions 


1. Set bits of accumulator. 
OR MASE. 7;SET BITS BY MASKING 
MASK has 1’s in the bit positions to be set and 0’s elsewhere. For example: 
OR 00010010B ;SET BITS 1 AND 4 


Remember, logically ORing a bit with 0 does not affect its value. Since SET can set 
only one bit at a time, we would need the following sequence to produce the same 
result: 


SET 1,A sSET BIT 1 
SET 4,A 7;AND THEN SET BIT 4 


2. Test a register pair for 0. Set the Zero flag if both halves of a register pair are 0. 


LD A,rph *TEST REGISTER PAIR FOR ZERO 

OR rpl 
The Zero flag is set if and only if both halves of register pair rp are 0. The accumulator 
and the other flags are also changed. 


3. Logical OR immediate with flags (condition codes). Logically OR a byte of 
immediate data with the flag register, setting those flags that are logically ORed with 
l’s. 

PUSH AF ;MOVE AF TO A REGISTER PAIR 
POF rp 
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LD A, MASK >SET FLAGS 

OR rpl 

Lo rpl,A 

PUSH rp sRESTORE AF WITH FLAGS SET 
POP AF 


This sequence changes a register pair (BC, DE, or HL). 


Logical EXCLUSIVE OR Instructions 


1. Complement bits of accumulator. 
XOR MASK s;COMPLEMENT BITS BY MASKING 
MASK has 1’s in the bit positions to be complemented and 0’s in the positions that are 
to be left unchanged. For example: 
XOR 11000000B8 sCOMPLEMENT BITS 46 AND 7 


Remember, logically EXCLUSIVE ORing a bit with 0 leaves it unchanged. 


2. Complement accumulator, setting flags. 
XOR LL1ILL1I11B 7 INVERT AND SET FLAGS 


Logically EXCLUSIVE ORing with all 1’s inverts all the bits. This instruction differs 
from CPL only in that it affects the flags, whereas CPL does not. 


3. Compare register with accumulator bit by bit, setting each bit position that is 
different. 
XOR reg 7;BIT BY BIT COMPARISON 


The EXCLUSIVE OR function is the same as a “not equal” function. Note that the 


Sign flag is 1 if the two operands have different values in bit 7. 


4. Add register to accumulator logically (that is, without any carries between bit 
positions). 
XOR reg LOGICAL ADDITION 


The EXCLUSIVE OR function is also the same as a bit-by-bit sum with no carries. 
Logical sums are often used to form checksums and error-detecting or error-correcting 
codes. 


Logical NOT Instructions 


1. Complement accumulator, setting flags. 
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XOR 111111118 7 INVERT AND SET FLAGS 


Logically EXCLUSIVE ORing with all 1’s inverts all the bits. This instruction differs 
from CPL only in that it affects the flags, whereas CPL does not. 


2. Complement bits of accumulator. 
XOR MASK ;COMPLEMENT BIT BY MASKING 


MASK has 1’s in the bit positions to be complemented and 0’s in the positions that are 
to be left unchanged. For example: 


XOR O1010001B COMPLEMENT BITS 0, 4, AND 6 
Remember, logically EXCLUSIVE ORing a bit with 0 leaves it unchanged. 


3. Complement memory location ADDR. 
LD HL, ADDR 


LD A, CHL) 7;OBTAIN DATA 
CPL 7; COMPLEMENT 
LD CHL),A ;RESTORE RESULT 


CPL applies only to the accumulator. 


4. Complement bit 0 of a register. 
INC reg 


or 


DEC reg 


Either instruction may, of course, affect the other bits in the register. The final value of 
bit 0 will surely be 0 if it was originally | and if it was originally 0. 


5. Complement bit 0 of a memory location. 


LD HL, ADDR 
INC CHL) 


or 
LD HL,ADDR 


DEC ‘¢HL) 
6. Complement digit of accumulator. 


- Less significant digit 
XOR OOO0O01111B ;COMPLEMENT LESS SIGNIFICANT DIGIT 
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- More significant digit 


XOR 11110000B 7;COMPLEMENT MORE SIGNIFICANT DIGIT 


These procedures are useful if the accumulator contains a decimal digit in negative 
logic, such as the input from a typical ten-position rotary or thumbwheel switch. 


7. Complement a register pair. 


LO HL, OFFFFH 7;SET HL TO ALL ONES 
AND A ;CLEAR CARRY 
SBC HL,rp s;SUBTRACT REGISTER PAIR FROM ALL ONES 


The result ends up in HL. 


Shift Instructions 


1. Shift accumulator left logically. 
ADD A,A 7;SHIFT A LEFT LOGICALLY 


Adding the accumulator to itself is equivalent to a logical left shift. 


2. Shift register pair HL left logically. 
ADD HL,HL ;SHIFT HL LEFT LOGICALLY 


3. Shift index register left logically. 
ADD xy, xy SHIFT IX OR IY LEFT LOGICALLY 


4. Shift register pair right logically. 


SRL orph 7;SHIFT MSB RIGHT LOGICALLY 
RR rpl 7AND THEN ROTATE LSB RIGHT 


The key point here is that the less significant byte must be rotated to pick up the Carry 
from the logical shifting of the more significant byte. 


5. Shift register pair right arithmetically. 


SRA rph ;SHIFT MSB RIGHT ARITHMETICALLY 
RR rpl 7;AND THEN ROTATE LSB RIGHT 


The rotation of the less significant byte is the same as in the logical shift. 


6. Shift memory locations ADDR and ADDR+1 (MSB in ADDR+1) left 
logically. 
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LD HL, ADDR 


SLA CHL) s;SHIFT LSB LEFT LOGICALLY 
INC HL 
RL CHL) 7;AND THEN ROTATE MSE LEFT 


OT 


LO xy, ADDR 
SLA (Cxy+t0) SHIFT LSB LEFT LOGICALLY 
RL Cxyti) ‘AND THEN ROTATE MSB LEFT 


To produce a 16-bit left shift, you must shift the less significant byte first and then 
rotate the more significant byte. 


7. Shift memory locations ADDR and ADDR+1 (MSB in ADDR-+1) right 
logically. 


LD HL, ADDR+ 1 


SRL (HL) SHIFT MSB RIGHT LOGICALLY 
DEC HL 
RR CHL) ;AND THEN ROTATE LSB RIGHT 


OT 


LD xy, ADDR 
SRL (xyti) SHIFT MSB RIGHT LOGICALLY 
RR Cxy+0) *AND THEN ROTATE LSB RIGHT 


8. Digit swap accumulator. That is, exchange the four least significant bits with the 
four most significant bits. 


RLCA *DIGIT SHIFT = 4 LEFT ROTATES 
RLCA 
RLCA 
RLCA 


or 


RRCA DIGIT SHIFT 
RRCA 
RRCA 
RRCA 


4 RIGHT ROTATES 


9. Normalize accumulator. That is, shift the accumulator left until its most signif- 
icant bit is 1. Do not shift at all if the accumulator contains 0. 


AND A sTEST ACCUMULATOR 
UIP M, DONE s;EXIT IF ALREADY NORMALIZED 
IR Z, DONE sEXIT IF ZERO 
SHIFT: ADD A,A ;QTHERWISE, SHIFT A LEFT 1 BIT 
UP P, SHIFT ;KEEP SHIFTING UNTIL NORMALIZED 


DONE: NOP 
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10. Normalize register pair HL. That is, shift the 16-bit number left until its most 
significant bit is 1. Do not shift the number at all if it is 0. 


LO A,H ;IS ENTIRE NUMBER 0? 
OR L 
JR Z, DONE 7YES, DONE 
SHIFT: ADD HL,HL s;SHIFT NUMBER LEFT 1 BIT 
JR NC, SHIFT ;KEEP SHIFTING UNTIL CARRY IS 1 
RR H 7;THEN SHIFT BACK ONCE 
RR L 
DONE : NOP 


ADD HL affects the Carry but not the Sign or Zero flag. 


Rotate Instructions 


1. Rotate register pair right. 


RRC rpl 7;COPY BIT O FOR ROTATION 
RL rpl 7;CARRY = BIT 90 

RR rph ;ROTATE MSB WITH BIT 0 
RR rpl 7 THEN ROTATE LSB RIGHT 


The RRC rpl instruction places bit 0 both in bit 7 and in the Carry flag; RL rpl then 
restores the register but leaves the original bit 0 in the Carry. 


2. Rotate register pair left. 


RLC rph 7;COPY BIT 15 FOR ROTATION 
RR rph 7;CARRY = BIT 15 

RL rpl 7;ROTATE LSB WITH BIT 15 
RL rph 7 THEN ROTATE MSB LEFT 


RLC rph places bit 7 of the more significant byte both in bit 0 and inthe Carry. RR rph 
then restores the register but leaves the original bit 7 (bit 15 of the 16-bit register pair) in 
the Carry. . 


3. Rotate accumulator left through Carry, setting flags. 
ADC A,A s;ROTATE LEFT AND SET FLAGS 
This instruction is the same as RLA, except that it affects all the flags whereas RLA 
affects only the Carry. 


4. Rotate register pair right through Carry. 


RR rph 7ROTATE MSB RIGHT WITH CARRY 
RR rpl 7 THEN ROTATE LSB RIGHT WITH CARRY 
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5. Rotate register pair left through Carry. 
RL rpl ROTATE LSB LEFT WITH CARRY 
RL. rph 7;ROTATE MSB LEFT WITH CARRY 


6. Rotate memory locations ADDR and ADDR+1 (MSBin ADDR-+1) right | bit 
position through Carry. 


LD HL, ADDR+1 


RR CHL) sROTATE MSB RIGHT WITH CARRY 
REC HL 
RR CHL) * THEN ROTATE LSB RIGHT WITH CARRY 


OT 


LD xy, ADOR 
RR Cxyt1) ROTATE MSB RIGHT WITH CARRY 
RR ixy+0) ® THEN ROTATE LSB RIGHT WITH CARRY 


7. Rotate memory locations ADDR and ADDR+ 1 (MSBin ADDR- 1) left one bit 
position through Carry. 


LD HL, ADDR 


RL CHL) 7;ROTATE LSB LEFT WITH CARRY 
INC HL 
RL CHL) 7 THEN ROTATE MSB LEFT WITH CARRY 


Or 


LD xy, ADDR 
RL (xyt+O) 7;ROTATE LSB LEFT WITH CARRY 
RL Cxy+t1) ; THEN ROTATE MSB LEFT WITH CARRY 


Test Instructions 


1. Test accumulator. Set flags according to the value in the accumulator without 
changing that value. 


AND A ?TEST ACCUMULATOR 
Or 
OR A TEST ACCUMULATOR 


Both alternatives clear the Carry. 


2. Test register. Set flags according to the value in a register without changing that 
value. 


INC reg sTEST REGISTER 
DEC reg 


This sequence does not affect the Carry or the accumulator. 
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3. Test memory location. Set flags according to the value in memory location 
ADDR without changing that value. 


LD HL, ADDR 7 TEST MEMORY LOCATION ADDR 
INC CHL) 
DEC CHL) 


This sequence does not affect the Carry or the accumulator. 


4. Test register pair. Set the Zero flag according to the value in a register pair 
without changing that value. 


Lo A,rph sTEST REGISTER PAIR 
QR rpl 


This sequence changes the accumulator and the other flags. 


5. Test index register. Set the Zero flag according to the value in an index register 
without changing that value. 


PUSH xy sMQOVE INDEX REG TO REGISTER PAIR 
POF rp 

LD A,rph sTEST REGISTER PAIR 

OR rpl 


This sequence changes a register pair, the accumulator, and the other flags. 


6. Test a pair of memory locations. Set the Zero flag according to the contents of 
memory locations ADDR and ADDR+1. 


LD HL, (ADDR) 7 TEST A MEMORY WORD 
LD A,H 
OR L 


This sequence changes HL, the accumulator, and the other flags. 


7, Test bits of accumulator. Set the Zero flag if all the tested bits are 0’s and clear the 
Zero flag otherwise. 


AND MASE ;TEST BITS BY MASKING 
MASK has 1’s in the bit positions to be tested and 0’s elsewhere. The Zero flag is set 
to | if all the tested bits are 0’s and to 0 otherwise. For example: 
AND 10000001B s;TEST BITS O AND 7 


The Zero flag is set to | if bits 0 and 7 of the accumulator are both zero, and to 0 
otherwise. The BIT instruction, on the other hand, can only handle one bit at a time; 
for example: 


BIT 7,A ;TEST BIT 7 


QA 780 ASSEMBLY LANGUAGE SUBROUTINES 


To duplicate the AND instruction, we would need the sequence 


BIT 7,4 s;TEST BIT 7 
JR NZ, DONE sEXIT IF IT IS 1 
BIT 90,4 ;TEST BIT O 

DONE : NOP 


8. Compare register with accumulator bit by bit. Set each bit position that is 
different to 1. 


XOR reg ;BIT-BY-BIT COMPARISON 
The EXCLUSIVE OR function is the same as a “not equal” function. 


9. Bit test. Set flags as if the accumulator had been logically ANDed witha memory 
location, but do not change the accumulator. 


LoD reg,A 7SAVE ACCUMULATOR 

LD HL, ADDR 

AND (HL) 7;PERFORM LOGICAL AND 
LD A,reg 7RESTORE ACCUMULATOR 


DATA TRANSFER INSTRUCTIONS 


In this group, we consider load, store, move, exchange, input, output, clear, and set 
instructions. We also include arithmetic instructions (such as subtracting the accumu- 
lator from itself) that move a specific value or the contents of another register to the 
accumulator or other destination without changing any data. 


Load Instructions 


1. Load register direct. 


LO A, (ADDR) 
LO reg,A 


or 


LO HL, ADDR 
LO reg, (HL) 


The first alternative uses the accumulator, while the second alternative uses register 
pair HL. 
2. Load register indirect. 


- From address in HL 
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LD reg, (HL) 


- From address in BC or DE 


LD A, (rp) 
LD reg,A 


Note that only the accumulator can be loaded indirectly via BC or DE. 
- From address in an index register 


LD reg, (xy+0) 


3. Load flag register with the 8-bit number VALUE. 


LD rpl, VALUE ;PUT VALUE IN LSB OF REGISTER PAIR 
PUSH rp sMOVE TO FLAGS THROUGH STACK 
POP AF 


The limitation of pushing and popping register pairs causes some unnecessary 
operations. 


4. Load interrupt vector register with the 8-bit number VALUE. 
LO A, VALUE 
LO I,A 


5. Load refresh register with the 8-bit number VALUE. 


LD A, VALUE 
LD R,A 


6. Load flag register direct from memory location ADDR. 


LD HL, (ADDR) 7;LOAD L FROM ADDR 
PUSH HL 7HL TO STACK, L ON TOP 
POP AF 7;HL TO AF WITH L TO FLAGS 


This procedure allows a user to initialize the flag register for debugging or testing 
purposes. Note that it changes the accumulator and the less significant byte of a 
register pair. 


7. Load interrupt vector register direct from memory location ADDR. 


LD A, (ADDR) 
LD I,A 


8. Load refresh register direct from memory location ADDR. 


LD A, (ADDR) 
LO R,A 
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9. Load register pair HL indirect from address in HL. 


LD A, CHL) LOAD LSB 
ING HL 

LO H, CHL) LOAD MSB 
LD L,A 


10. Load register pair (BC or DE) indirect from address in HL. 


LO rpl, CHL) ;LOAD LSB 

INC HL 

LD rph, CHL) ;LOAD MSB 

DEC HL 7;RESTORE HL TO ORIGINAL VALUE 


11. Load alternate processor status (AF’) from stack. 


POF AF 
EX AF, AF” 


12. Load memory locations PTR and PTR+1 (MSB in PTR+1) with ADDR. 


LD HL, ADDR 7;GET INDIRECT ADDRESS 
LD (PTR), HL 7;STORE INDIRECT ADDRESS IN MEMORY 


Store Instructions 


1. Store register direct. 


LO A,reg 
LO C(ADDOR),A 


Or 


LO HL, ADDR 
LO CHL), reg 


The first alternative uses the accumulator, whereas the second uses register pair HL. 


2. Store register indirect. 
- At address in HL 
LD CHL),reg 


- At address in DE or BC 


LO A,reg 
LD (rp),A 


Only the accumulator can be stored at the address in BC or DE. 
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- At address in an index register 


LOD (xyt+O),reg 


3. Store flag register direct. 


PUSH AF 3F TO TOP OF STACK 

POP HL 7F TOL 

LD (ADDR), HL 7F TQ ADDR, DESTROY ADDR+1 
or 

PUSH AF 7F TQ TOP OF STACK 

POP HL 7F TO L 

LD A,L 7F TO A 

STA ADDR 7;F TO ADDR 


4. Store interrupt vector register direct. 


LD A,I 
LO CADDR),A 


5. Store refresh register direct. 
LD A,R 
LD CADDRI,A 


6. Store register pair (BC or DE) indirect at address in HL. 


LD CHLD,rpl ;STORE LSB 

INC HL 

LD CHL), rph 7;STORE MSB 

DEC HL ;RETURN HL TO ORIGINAL VALLIE 


The register pair is stored in memory in the usual upside-down fashion. 


7. Store alternate processor status (AF’) in stack. 


EX AF, AF” 
PUSH AF 


Move Instructions 


I. Transfer accumulator to flag register. 


LD rpl,A 

PUSH rp 

POP AF 
The flag register is the less significant byte of register pair AF. This sequence also 
changes the accumulator and the less significant byte of a register pair (i.e., C, E, or L). 
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2. Transfer flag register to accumulator. 


PUSH AF 
POP rp 
MOV A,rpl 


This sequence changes register pair rp. 


3. Move register pair | to register pair 2. 
LD rp2l,rpil 
LD rp2h,rpih 


This sequence transfers the contents of register pair rp] to rp2 without changing rp1l. 
Remember, EX DE,HL exchanges register pairs DE and HL specifically. 


4. Move stack pointer to HL. 


LD HL, © 
ADD HL,SP 


5. Move stack pointer to an index register. 


LOD xy,O 
ADD xy,SP 


6. Move index register to register pair. 


PUSH xy 
POP rp 


7. Move register pair to index register. 


PUSH rp 
POP xy 


8. Move index register IX to index register IY. 


PUSH IX 
POP IY 


9. Move index register IY to index register IX. 


PUSH IY 
POP IX 


10. Move HL to program counter. 
JP (HL) 
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11. Move index register to program counter. 


JP (xy) 


12. Move memory locations ADDR and ADDR+1 (MSB in ADDR-+1) to the 
program counter (an indirect jump). 


LD HL, (ADDR) 
JP CHL) 


13. Move multiple (fill). Place the accumulator in successive memory locations 
starting at the address in register pair HL. The number of bytes to be filled (one or 
more) 1s in register B. 


FILBYT: LD (HL),A ;FILL A MEMORY LOCATION 
INC HAL 7;POINT TO NEXT LOCATION 
DJINZ FILBYT ;COUNT BYTES 


This routine can initialize an array or buffer. If more than 256 bytes are to be filled, 
the repeated block move instructions become handy. The approach is to fill the first 
byte from the accumulator and then use a repeated block move to fill the succeeding 
bytes. The destination pointer is always one byte ahead of the source pointer, so the 
data being moved is always the same. 


LD CHL),A sFILL THE FIRST BYTE MANUALLY 

LD D,H ;DESTINATION POINTER IS 1 BYTE UP 
LD E,L 

INC DE 

DEC BC 7;COUNT DOWN 1 BYTE 

LOIR s;FILL THE REST AUTOMATICALLY 


Exchange Instructions 


1. Exchange registers using the accumulator. 


LO A,regl 
LD regi,reg2 
LO reg2,A 


2. Exchange register pairs. 


- DE with HL 
EX DE, HL 
- BC with HL 
PUSH BC 7;BC TO TOP OF STACK 
EX HL, (SP) 3;BC TO HL, HL TO TOP OF STACK 


POP BC 7;HL TO BC 
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EX HL,(SP) exchanges HL with the top of the stack. 
- general, rp! with rp2 


PUSH rpl 7;PUT RP1, RP2 IN STACK 

PUSH rp2 

POP rpil s;EXCHANGE BY POPPING IN WRONG ORDER 
POP rp2 


3. Exchange stack pointer with HL. 


EX DE,HL sHL TO DE 

LD  HL,O 7SP TO HL 

AnD HL,SP 

EX DE,HL ;SP TO DE, RESTORE HL 
LO $P,HL ;HL TO SP 

EX DE,HL :SP TO HL 


This procedure can be used to differentiate between the user stack and the operating 
system or monitor stack. 


4. Exchange index register with register pair. 


PUSH xy >SAVE INDEX REG, REG PAIR IN STACK 
PUSH rp 

POP xy EXCHANGE BY POPPING IN WRONG ORDER 
FOF rp 


5. Exchange index registers. 


PUSH IX ;SAVE BOTH INDEX REGISTERS IN STACK 
PUSH IY 
POP IX ;EXCHANGE BY POPPING IN WRONG ORDER 
POP IY 


Ciear Instructions 


1. Clear the accumulator. 


SUB A 
or 

XOR A 
Or 

LD 4,90 


The third alternative executes more slowly and occupies more memory than the 
other two, but does not affect the flags. 
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2. Clear a register. 


LD reg,Q 


3. Clear memory location ADDR. 


SUB A 
LD CADDR),A 


or 


LO HL, ADDR 
LD C(HL),O 


The second alternative executes more slowly than the first, but does not affect the 
accumulator or the flags. Of course, it does use register pair HL. 


4. Clear a register pair. 


LD rp,9O 


5. Clear memory locations ADDR and ADDR+1. 


LO HL,9O 
LD CADDR), HL 


HL is faster to use here than DE or BC. 


6. Clear Carry flag. 
AND A 


or 
OR A 
Any other logical instruction (except CPL) will also clear the Carry, but these two 
are particularly useful because they do not change the accumulator. Remember, 
ANDing or ORing a bit with itself does not affect its value. To clear Carry without 
affecting any other flags, use the sequence 


SCF 7;FIRST SET CARRY FLAG 
CCF 7 THEN CLEAR CARRY BY COMPLEMENTING 


7. Clear bits of accumulator. 
AND MASK sCLEAR BITS BY MASKING 


MASK has 0’s in the bit positions to be cleared and 1’s in the positions that are to be 
left unchanged. For example: 
AND 101111108 sCLEAR BITS O ANE 4 


RES can clear only one bit at a time. 
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Set Instructions 


1. Set the accumulator to FF j¢ (all 1’s in binary). 
LO A, OFFH 


or 


SUB A 
DEC A 


2. Set register to FFy¢. 
LD reg, OFFH 


3. Set memory location ADDR to FF je. 


LD A, OFFH 
LD (ADDR), A 


or 


LD HL,ADDOR 
LD CHL) , OFFH 


4. Set bits of accumulator. 
QR MASK sSET BITS BY MASKING 


MASK has 1’s in the bit positions to be set and 0’s elsewhere. For example: 
OR 10110000B s;SET BITS 4, 5, AND 7 


The SET instruction can set only one bit at a time. 


BRANCH (JUMP) INSTRUCTIONS 


Unconditional Branch Instructions 


1. Jump indirect. 


* To address in HL 
JP CHL) 


- To address at the top of the stack 
RET 


Note that RET is just an ordinary indirect jump that obtains its destination from the 
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top of the stack. RET can be used for purposes other than returning from a subroutine. 


- To address in DE 


EX DE, HL 
JP CHL) 


- To address in BC 


Or 


LD H,B 
LD L,C 
JP CHL) 


PUSH BC 
RET 


The second alternative is much slower than the first (21 cycles as compared to 12 
cycles), but does not change HL. 


- To address in an index register 


JP (xy) 


- To address in memory locations ADDR and ADDR+1 


LD HL, ADDR 7;FETCH INDIRECT ADDRESS 
IP CHL) 7;AND BRANCH TO IT 


2. Jump indexed, assuming that the base of the address table is in register pair HL 
and the index is in the accumulator. 


ADD A,A sDOUBLE INDEX FOR 2-BYTE ENTRIES 
Lo E,A sEXTEND INDEX Ta 16 BITS 

LD 0,0 

ADD HL,DE sCALCULATE ADDRESS OF ELEMENT 

LD E, CHL) sFETCH ELEMENT FROM ADDRESS TABLE 
INC HL 

LD QD, CHL? 

EX DE, HL csAND JUMP TO IT 

IP CHL) 


We have assumed that the address table (jump table) consists of as many as 128 2-byte 
entries, stored in the usual Z80 format with the less significant byte at the lowei 
address. A typical table would be 


JTAB: 


DW ROUTO ,;ADDRESS ENTRY © 
DW ROUT 1 ;ADDRESS ENTRY 1 
DW ROUT2 7;ADDRESS ENTRY 2 


3. Jump and link; that is, transfer contro] to address DEST, saving the current 
program counter in register pair HL. 
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LD HL, HERE 7LOAD H AND L WITH LINE 
HERE : JP DEST 7 TRANSFER CONTROL 


This procedure can provide a subroutine capability that does not use the stack. The 
subroutine can return control by adjusting the link and executing JP (HL). For 
example, to return control to the instruction immediately following JP DEST, the 
subroutine would have to add 3 to HL (since JP DEST occupies 3 bytes). Of course, 
the link could also be changed to HERE+3. 


Conditional Branch Instructions 


1. Branch if 0. 
- Branch if accumulator contains 0 


AND A TEST ACCUMULATOR 
JR Z, DEST 


- Branch if a register contains 0 
INC reg ;TEST REGISTER 
DEC reg 
JR Z,DEST 


- Branch if memory location ADDR contains 0 


LOD HL, ADDR 3TEST MEMORY LOCATION 
INC CHL) 

DEC CHL) 

JR Z, DEST 


or 


LD A, (ADDR) 7TEST MEMORY LOCATICN 
AND A 
JR Z, DEST 


- Branch if a register pair contains 0 
LD A,rph sTEST REGISTER PAIR 


OR rpl 
JR Z, DEST 


- Branch if an index register contains 0 


PUSH xy sMOVE INDEX REGISTER TO REGISTER PAIR 
POP rp 

LD A,rph sTEST REGISTER PAIR 

QR rpl 


JR Z, DEST 
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- Branch if memory locations ADDR and ADDR+1 both contain 0 


LD HL, (ADDR) ;TEST A 16-BIT NUMBER IN MEMORY 
LD 4,H 
aR L 


JR Z, DEST 
- Branch if a bit of a register is 0 


BIT N,reg ;TEST BIT N OF REGISTER 
UR Z, DEST 


Special cases are 
- Branch if bit 7 of the accumulator is 0 


AND A ;TEST BIT 7 OF ACCLIMULATOR 
IP P, DEST 


or 


RLA ;MOVE BIT 7 TQ CARRY 
AR NC, DEST 


The second alternative allows relative jumps, but it also changes the accumulator. 
- Branch if bit 6 of the accumulator is 0 
ADD A,A s;SET SIGN FROM BIT 4 
JP P, DEST THEN TEST SIGN FLAG 
- Branch if bit 0 of the accumulator is 0 


RRA sMOQVE BIT 0 TO CARRY 
JR NC, DEST ;AND TEST CARRY 


- Branch if a bit of a memory location is 0 


LD HL, ADDR 
BIT N, CHL) 7;TEST BIT N OF MEMORY LOCATION ADDR 
JR Z, DEST 


- Branch if interrupts are disabled (that is, if interrupt flip-flop IFF2 is 0) 
LO A,I ?;MOQVE IFF2 TO P/V FLAG 
uIP PO, DEST 


The instruction LD A,I and LD A,R both move interrupt enable flip-flop IFF2 to 
the Parity/Overflow flag. This sequence can be used to save the current interrupt 
status before executing a routine that must run with interrupts disabled. That status 
can then be restored afterward. 


2. Branch if not 0. 


- Branch if accumulator does not contain 0 


AND A ;TEST ACCUMULATOR 
JR NZ, DEST 
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- Branch if a register does not contain 0 


INC reg sTEST REGISTER 
DEC reg 
JR NZ, DEST 


- Branch if memory location ADDR does not contain 0 


LD HL, ADDR sTEST MEMORY LOCATION 
INC (CHL) 
DEC CHL) 
JR NZ,DEST 

Or 
LD A, (ADDR) 7TEST MEMORY LOCATION 
AND A 


JR NZ, DEST 
»* Branch if register pair does not contain 0 


LD A,rph s; TEST REGISTER PAIR 
OR rpl 
JR NZ, DEST 


- Branch if index register does not contain 0 


PUSH xy ;TRANSFER INDEX REGISTER TQ REG PAIR 
POP rp 

LD 6A, rph ;TEST REGISTER PAIR 

OR rpl 


JR NZ, DEST 
- Branch if memory locations ADDR and ADDR+1 do not both contain 0 


Lo HL, (ADDR) ;TEST 16-BIT NUMBER IN MEMORY 
LD A,H 
OR L 


JR NZ, DEST 


- Branch if a bit of a register is | 
BIT N,reg sTEST BIT N OF REGISTER 
JR NZ, DEST 
Special cases are 
* Branch if bit 7 of the accumulator is 1 


AND A 7TEST BIT 7 OF ACCUMULATOR 
JP M, DEST 
Or 
RLA s;MOVE BIT 7 TQ CARRY 
JR C, DEST 


The second alternative allows relative jumps, but it also changes the accumulator. 
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- Branch if bit 6 of the accumulator is | 


ADD A,A 7;SET SIGN FROM BIT 6 
UP M, DEST 3THEN TEST SIGN FLAG 


- Branch if bit 0 of the accumulator is 1 


RRA ;MQVE BIT 0 TO CARRY 
JR C, DEST 7 THEN TEST CARRY 


- Branch if a bit of a memory location is | 


LD HL, ADDR 
BIT N, CHL) 7;TEST BIT N OF MEMORY LOCATION ADDR 
JR NZ, DEST 


- Branch if interrupts are enabled (that is, if interrupt flip-flop IFF2 is 1) 


LD A,I s;MQVE IFF2 TO P/V FLAG 
UIP PE, DEST 


The instructions LD A,I and LD A,R both move interrupt enable flip-flop IFF2 to 
the Parity/ Overflow flag. This sequence can be used to save the current interrupt 
status before executing a routine that must run with interrupts disabled. That status 
can be restored afterward. 


3. Branch if Equal. 
- Branch if (A) = VALUE 


CP VALUE 7COMPARE BY SUBTRACTING 
JR Z, DEST 


The following special cases apply to any register or to a memory location addressed 
using HL or through indexing. 


- Branch if (reg) = | 


DEC reg ;CHECK BY DECREMENTING 
JR Z,DEST 7AND TESTING RESULT FOR ZERO 


This procedure can be applied to any primary register, to the memory location 
addressed through HL, or to memory locations addressed via indexing. 


- Branch if (reg) = FFi6 


INC reg 7;CHECK BY INCREMENTING 
JR Z, DEST 7AND TESTING RESULT FOR ZERO 


This procedure can be applied to any primary register, to the memory location 
addressed through HL, or to memory locations addressed via indexing. 


- Branch if (A) = (reg) 


CP reg 7COMPARE BY SUBTRACTING 
JR Z,DEST 
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* Branch if (A) = (ADDR) 


LD HL, ADDR s;COMPARE BY SUBTRACTING 
CP CHL) 
JR Z, DEST 


- Branch if (rp) = VALI6 


LD HL, VAL16 

AND A ;CLEAR CARRY 

SBC HL,rp 

JR Z, DEST 
Carry must be cleared, since the Z80 lacks a 16-bit subtract instruction without Carry. 
Note that the two’s complement of VAL16 cannot be added using ADD HL, since that 
instruction does not affect the Zero flag. 


- Branch if (HL) = (rp) 


AND A sCLEAR CARRY 
SBC HL,rp 
JR Z, DEST 


Note: Do not use either of the next two sequences to test for stack overflow or under- 
flow, since intervening operations could change the stack pointer by more than 1. 


- Branch if (SP) = VAL16 


LO HL, VAL16 

AND A s;CLEAR CARRY 
SBC HL,SP 

JR Z,DEST 


- Branch if (SP) = (HL) 


AND A ;CLEAR CARRY 
SBC HL,SP 
JR Z, DEST 


- Branch if (xy) = VALI6 


PUSH xy sMOVE INDEX REGISTER TO REGISTER PAIR 
POF rp 

LO HL, VALié46 * THEN COMPARE REGISTER PAIR, VAL16 
AND A :CLEAR CARRY 

SBC HL,SP 

JR Z, DEST 


ADD xy cannot be used to add the two’s complement of VAL16, since ADD xy does 
not affect the Zero flag. 
4. Branch if Not Equal. 
- Branch if (A) # VALUE 


CP VALUE 7;COMPARE BY SUBTRACTING 
JR NZ, DEST 
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The following special cases apply to any register or to a memory location addressed 
using HL or through indexing. 


- Branch if (reg) ¥ 1 


DEC reg sCHECK BY DECREMENTING 

JR NZ, DEST sAND TESTING RESULT FOR ZERO 
- Branch if (reg) ~ FF j¢ 

INC reg CHECK BY INCREMENTING 

JR NZ, DEST AND TESTING RESULT FOR ZERO 
- Branch if (A) ¥ (reg) 

CP reg COMPARE BY SUBTRACTING 


JR NZ, DEST 
- Branch if (A) # (ADDR) 


LO HL, ADDR sCOMPARE BY SUBTRACTING 
CP CHL ) 
JR NZ, DEST 


* Branch if (rp) ~ VALI16 


LO HL, VAL16 

AND A s;CLEAR CARRY 
SBC HL,rp 

JR NZ, DEST 


- Branch if (HL) ¥ (rp) 


AND A ;CLEAR CARRY 
SBC HL,rp 
JR NZ, DEST 
Note: You should not use either of the next two sequences to test for stack overflow 
or underflow, since intervening operations could change the stack pointer by more 
than I. 


- Branch if (SP) ~# VALI6 


LD HL, VAL16 
AND 
SBC HL,SP 

IR NZ, DEST 


- Branch if (SP) ¥ (HL) 


AND A ;CLEAR CARRY 
SBC HL,SP 
JR NZ, DEST 


- Branch if (xy) # VALI16 


PUSH xy sMOVE INDEX REGISTER TQ REGISTER PAIR 
POP rp 


> 


;CLEAR CARRY 
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LD HL, VAL16 7THEN COMPARE REGISTER PAIR AND VAL16 
AND A ;CLEAR CARRY 
SBC HL,rp 


JR NZ, DEST 


ADD xy cannot be used to add the two’s complement of VAL16, since ADD xy does 
not affect the Zero flag. 


5. Branch if Positive. 
- Branch if contents of accumulator are positive 


AND A 7TEST ACCUMLILATOR 
JP F, DEST 


- Branch if contents of a register are positive 


INC reg sTEST REGISTER 
DEC reg 
JP P, DEST 


- Branch if contents of memory location ADDR are positive 


LOD HL, ADDR 7;TEST MEMORY LOCATION 
INC CHL) 
DEC CHL) 
JP P, DEST 
OT 
LD A, (ADDR) 7;TEST MEMORY LOCATION 
AND A 
JP P, DEST 


- Branch if contents of a register pair are positive 
INC rph TEST MORE SIGNIFICANT BYTE ONLY 


DEC rph 
uP P, DEST 


- Branch if contents of index register are positive 


PUSH xy 7 TRANSFER INDEX REGISTER TQ AF 
POP AF 

AND A ;TEST MORE SIGNIFICANT BYTE ONLY 
JP P, DEST 


- Branch if 16-bit number in memory locations ADDR and ADDR-+1 (MSB in 
ADDR-+ 1) is positive 


LD A, CADDR+1) 7;TEST MORE SIGNIFICANT BYTE ONLY 
AND A 


JP P,DEST 
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or 


LD HL, ADDR+1 7TEST SIGN BIT OF MSB 
BIT 7, CHL) 
JR Z, DEST 


6. Branch if Negative. 


- Branch if contents of accumulator are negative 


AND A 7TEST ACCUMLILATOR 
IP M, DEST 


- Branch if contents of a register are negative 


INC reg sTEST PRIMARY REGISTER 
NEC reg 
JP M, DEST 


- Branch if contents of memory location ADDR are negative 


LD HL, ADDR ;TEST MEMORY LOCATION 
INC CHL) 
DEC CHL) 
IP M, DES 
Or 
LD A, (ADDR) 7;TEST MEMORY LOCATION 
AND A 
JP M, DEST 


- Branch if contents of a register pair are negative 


INC rph TEST MORE SIGNIFICANT BYTE ONLY 
DEC rph 
JP M, DEST 
- Branch if contents of an index register are negative 
PUSH xy ;MOQVE INDEX REGISTER TO AF 
POP AF 
AND A sTEST MORE SIGNIFICANT BYTE ONLY 
JP M, DEST 


- Branch if 16-bit number in memory locations ADDR and ADDR+1 (MSB in 
ADDR-+ 1) is negative 


LD A, (ADDR+1) s;TEST MORE SIGNIFICANT BYTE ONLY 
AND A 
JP M, DEST 
Or 
Lo HL, ADDR+1 7;TEST SIGN BIT OF MSB 
BIT 7, CHL) 


JR NZ, DEST 
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7. Signed Branches. 


These sequences must allow for two’s complement overflow. After a comparison, the 
setting of the Parity /Overflow flag indicates that overflow occurred. The branches are 
JP PE (Branch on Overflow) and JP PO (Branch on No Overflow). The idea then is to 
force a branch if the specified condition holds and overflow did not occur (a true 
positive), or if the condition does not hold but overflow did occur (a false negative). 
The operand in the initial comparison (indicated as oper) could be a data byte, a 
register, (HL), or an indexed address. 


- Branch if accumulator is greater than other operand (signed) 


CP aper ;PERFORM COMPARISON 

JP PE,CHRVS ;BRANCH IF OVERFLOW OCCURRED 

UP M, DONE 3;NQ OVERFLOW - NO BRANCH ON NEGATIVE 
JR NZ, DEST ; BRANCH IF RESULT NON-ZERO POSITIVE 


JR DONE 
CHRVS: JP M, DONE 7 BRANCH IF NEGATIVE BUT OVERFLOW 
DIONE : NOP 


This sequence forces a branch if the result is greater than 0 and overflow did not 
occur, or if the result is less than 0 but overflow did occur. 


- Branch if accumulator is greater than or equal to other operand (signed) 


CP oper ;PERFORM COMPARISON 
JP PE,CHRVS ;BRANCH IF OVERFLOW OCCURRED 
PF P, DEST ;BRANCH IF NO OVERFLOW, POSITIVE 


IR DONE 
CHRVS: uP M, DEST ;BRANCH IF OVERFLOW, NEGATIVE 
DONE : NOP 


This sequence forces a branch if the result is greater than or equal to 0 and overflow 
did not occur, or if the result is less than 0 but overflow did occur. 


* Branch if accumulator is less than other operand (signed) 


CP oper sPERFORM COMPARISON 
uIP PE,CHRVS ;BRANCH IF OVERFLOW OCCURRED 
JF M,DEST * BRANCH IF NOQ OQVERFLOW, NEGATIVE 


JR DONE 
CHRVS: JP P,DEST ;BRANCH IF QVERFLOW, POSITIVE 
DONE : NOP 


This sequence forces a branch if the result is less than 0 and overflow did not occur, 
or if the result is greater than or equal to 0 and overflow did occur. 


- Branch if accumulator is less than or equal to other operand (signed) 


CP oper ;PERFORM COMPARIS(N 
IP PE,CHRVS ;BRANCH IF OQVERFLOW OCCURRED 
. JP M, DEST sBRANCH IF NO OVERFLOW, NEGATIVE 
JR Z, DEST 7 BRANCH IF NO OVERFLOW, ZERO 
IR DONE 
CHRVS: JP M, DONE 
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JR NZ, DEST yBRANCH IF OQVERFLOW, POSITIVE 
DONE: NOP 
This sequence forces a branch if the result is less than or equal to 0 and overflow did 
not occur, or if the result is greater than 0 and overflow did occur. 


8. Branch if Higher (Unsigned). 


Branch if the operands being compared are not equal and the comparison does not 
require a borrow. The special problem here is avoiding a branch when the operands are 
equal. 


- Branch if (A) > VALUE (unsigned) 


CP VALUE 7COMPARE BY SUBTRACTING 

JR C, DONE ;NQ BRANCH IF BORROW NEEDED 

JR NZ, DEST 7BRANCH IF NO BORROW, NOT EQUAL 
DONE : NOP 


Comparing equal numbers clears Carry. An alternative approach is 


CP VALUE+1 s;COMPARE BY SUBTRACTING VALUE+1 
JR NC, DEST sBRANCH IF NO BORROW NEEDED 


- Branch if (A) > (reg) (unsigned) 


CP reg ;COMPARE BY SUBTRACTING 
JR C, DONE 7;NQ BRANCH IF BORROW NEEDED 
JR NZ, DEST yBRANCH IF NOG BORROW, NOT EQUAL 


DONE: NOP 
Or 


Ln regl,A sFORM REG - A 
LOD A,reg 


CP regi 
JR NC, DEST s BRANCH IF BORROW NEEDED 


Or 


INC reg 7FORM A - REG - 1 

CP reg 

JR NC, DEST BRANCH IF NO BORROW NEEDED 
In the third alternative, we could replace INC reg with DEC A, thus changing the 
accumulator instead of the register. 


- Branch if (A) > (ADDR) (unsigned) 


LO HL, ADDR 

CP CHL) ;COMPARE BY SUBTRACTING 

JR C, DONE 7NQ BRANCH IF BORROW NEEDED 

IR NZ, DEST ;BRANCH IF NO BORROW, NOT EQUAL 
DONE : NOP 


Or 
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LD reg,A 7;FORM CADDR) - A 

LD A, (ADDR) 

CP reg 

JR C, DEST ; BRANCH IF BORROW NEEDED 
- Branch if (HL) > (rp) (unsigned) 

SCF SET CARRY FLAG 

SBC HL,rp 

JR NC, DEST :BRANCH IF NO BORROW NEEDED 
* Branch if (HL) > VALI16 (unsigned) 

LD rp,-VAL1é—-1 sFORM HL — VALI6 - 1 

ADD HL,rp 

JR C,DEST BRANCH IF NO BORROW NEEDED 


Carry is an inverted borrow here, since we are subtracting by adding the two’s 
complement. 


- Branch if (SP) > (HL) (unsigned) 


AND A 7;CLEAR CARRY FLAG 
SBC HL,SP 
JR C, DEST 


- Branch if (SP) > VALI6 (unsigned) 


LD HL ,-VAL 16-1 sFORM SP - VALI46 - 1 

ADD HL,S 

JR C, DEST *BRANCH IF NO BORROW GENERATED 
- Branch if (xy) > VALI16 (unsigned) 

LD rp, -VAL1Lé-1 s;FORM XY -— VALI4 - 1 

ADD xy,rp 

JR C, DEST BRANCH IF NO BORROW GENERATED 
- Branch if (xy) > (HL) (unsigned) 

PUSH xy sMOVE INDEX REGISTER TQ REGISTER PAIR 

POF rp 

AND A CLEAR CARRY FLAG 

SBC HL,rp 

JR C, DEST 


9. Branch if Not Higher (Unsigned). 


Branch if the operands being compared are equal or the comparison requires a 
borrow. The special problem here is forcing a branch if the operands are equal. 


- Branch if (A) = VALUE (unsigned) 


CP VALUE sCOMPARE BY SUETRACTING 
IR Cc, DEST ;BRANCH IF BORROW NEEDED 
JR Z, DEST > OR IF EQUAL 


or 
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CP VALUE+1 sCOMPARE BY SUBTRACTING VALUE+1 
JR C, DEST sBRANCH IF BORROW NEEDED 


* Branch if (A) S (reg) (unsigned) 


CP reg sCOMPARE BY SUBTRACTING 
JR C, DEST * BRANCH IF BORROW NEEDED 
JR Z, DEST > QR IF EQUAL 
or 
LO regl,A sFORM REG - A 
LO A,reg 
CP regi 
JR NC, DEST s BRANCH IF NO BORROW NEEDED 
or 
INC reg sFORM A —- REG - 1 
CP reg 
JR C, DEST BRANCH IF BORRGW NEEDED 


In the third alternative, we could replace INC reg with DEC A, thus changing the 
accumulator instead of the register. 


- Branch if (A) S (ADDR) (unsigned) 
LD HL, ADDR 


CF CHL) sCOMFARE BY SUBTRACTING 
JR C, DEST s;BRANCH IF BORROW NEEDED 
JR Z, DEST >; OR IF EQUAL 
or 
LD reg,A ;FORM CADDR) - A 
LD CADDR),A 
CP reg 
JR NC, DEST BRANCH IF NO BORROW NEEDED 
- Branch if (HL) S (rp) (unsigned) 
SCF sSET CARRY FLAG 
SBC HL,rp sFORM HL - RP - 1 
JR C,DEST BRANCH IF BORROW NEEDED 


- Branch if (HL) = VALI6 (unsigned) 
LO rp, -VAL 16-1 


ADD HL,rp 7;FORM HL - VALI6é - 1 
JR NC, DEST 7 BRANCH IF BORROW NEEDED 


- Branch if (SP) S (HL) (unsigned) 


AND A sCLEAR CARRY 
SBC HL,SP ;FORM HL - SP 


IR NC, DEST sBRANCH IF NO BORROW NEEDED 
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- Branch if (SP) = VAL16 (unsigned) 


LD HL, ~VAL 16-1 sFORM SP - VALIG - 1 

ADO HL,SP 

IR NC, DEST s;BRANCH IF BORROW NEEDED 
- Branch if (xy) S VALI16 (unsigned) 

LO rp, -VALL6—-1 7FORM XY - VALI6 - 1 

ADD xy,rp 

JR NC, DEST 7; BRANCH IF BORROW NEEDED 


- Branch if (xy) S (HL) (unsigned) 


PUSH xy ;MOVE INDEX REGISTER TO REGISTER PAIR 
POF rp 

AND A s;CLEAR CARRY 

SBC HL,rp FORM HL - XY 

JR NC, DEST BRANCH IF NO BORROW NEEDED 


10. Branch if Lower (Unsigned). Branch if the unsigned comparison requires a 
borrow. 


- Branch if (A) < VALUE (unsigned) 


CP VALUE s;COMPARE BY SUBTRACTING 

WR C, DEST BRANCH IF BORROW NEEDED 
- Branch if (A) < (reg) (unsigned) 

CP reg sCOMPARE BY SUBTRACTING 

JR C, DEST ;BRANCH IF BORROW NEEDED 


- Branch if (A) < (ADDR) (unsigned) 
LD HL, ADDR 


CP CHL) sCOMPARE BY SUBTRACTING 

JR C, DEST 
- Branch if (HL) < (rp) (unsigned) 

AND A 3;FOQRM HL ~- RP 

SBC HL,rp 

JR C, DEST ;BRANCH IF BORROW NEEDED 
- Branch if (HL) < VALI6 (unsigned) 

LD rp, -VAL16 FORM HL - VALI6 

ADD HL,rp 

JR NC, DEST BRANCH IF BORROW NEEDED 
* Branch if (SP) < (HL) (unsigned) 

SCF sFORM HL - SP-1 

SBC HL,SP 


IR NC, DEST ;BRANCH IF NO BORROW NEEDED 
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- Branch if (SP) << VALI6 (unsigned) 


LD HL,-VAL16 7;FORM SF - VALI4 
ADD HL,SP 
JR NC, DEST 7; BRANCH IF NO BORROW NEEDED 


- Branch if (xy) << VALI16 (unsigned) 


LO rp, -VALI16 *FORM XY —- VALI4 
ADO xy,rp 
JR NC, DEST s BRANCH IF NO BORROW NEEDED 


- Branch if (xy) < (HL) (unsigned) 


PUSH xy *MCIVE INDEX REGISTER TO REGISTER PAIR 
POF rp 

SCF *FORM HL —- XY-1 

SBC HL,rp 

JR NC, DEST *BRANCH IF NO BORROW NEEDED 


11. Branch if Not Lower (Unsigned). Branch if the unsigned comparison does not 
require a borrow. 


- Branch if (A) = VALUE (unsigned) 


cP VALUE ;COMPARE BY SUBTRACTING 

uJIR NC, DEST ; BRANCH IF NO BORRQW NEEDED 
- Branch if (A) = (reg) (unsigned) 

CP reg COMPARE BY SUBTRACTING 

JR NC, DEST * BRANCH IF NO BORROW NEEDED 


* Branch if (A) = (ADDR) (unsigned) 


Ln HL, ADDR 
CP CHL) sCQMPARE BY SUBTRACTING 
UR NC, DEST * BRANCH IF NO BORROW NEEDED 


- Branch if (HL) = (rp) (unsigned) 


AND A s;FORM HL - RP 

SEC HL,rp 

JR NC, DEST BRANCH IF NO BORROW NEEDED 
- Branch if (HL) = VALI16 (unsigned) 

LOD rp,-VAL14 ;FORM HL —- VAL146 

ADD HL,rp 

JR C, DEST ;BRANCH IF NOG BORROW NEEDED 


- Branch if (SP) = (HL) (unsigned) 


SCF 7;FORM HL - SP-1 
SBC HL,SP 
JR C, DEST ;BRANCH IF BORROW NEEDED 
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- Branch if (SP) = VALI6 (unsigned) 


Lo HL,-VAL1& :FORM SP - VALI4 
ADO HL,rp 
JR c, DEST »BRANCH IF NQ BORROW NEEDED 


* Branch if (xy) = VAL16 (unsigned) 


LD rp,-VALI& 3;FORM XY -— VAL146 
ADO xy,SP 
JR C, DEST * BRANCH IF NQ BORROQW NEEDED 


* Branch if (xy) = (HL) (unsigned) 


PUSH xy s TRANSFER INDEX REG TO REGISTER PAIR 
POF rp 
SCF sFORM HL —- XY - 1 
SBC HL,rp 
uIR C, DEST BRANCH IF BORROW NEEDED 
SKIP INSTRUCTIONS 


Skip instructions can be implemented on the Z80 microprocessor by using jump 
instructions with the proper destination. That destination should be one instruction 
beyond the one that follows the jump sequentially. The actual number of bytes skipped 
will vary, since Z80 instructions vary from one to four bytes in length. 


SUBROUTINE CALL INSTRUCTIONS 


Unconditional Call Instructions 


An indirect call on the Z80 microprocessor can be implemented by calling a routine 
that performs an indirect jump. An RET instruction at the end of the subroutine will 
then transfer control back to the original calling point. The main program performs 


CALL TRANS 


where subroutine TRANS transfers control to the ultimate destination. Note that 
TRANS ends with a jump, not with a return. Typical TRANS routines are 


- To address in HL 
TRANS: JP CHL) sENTRY POINT IN HL 
- To address in an index register 


TRANS: JP (xy) sENTRY POINT IN AN INDEX REGISTER 


CHAPTER 2: IMPLEMENTING ADDITIONAL INSTRUCTIONS AND ADDRESSING MODES 119 


- To address in DE 


TRANS: EX DE, HL SENTRY POINT IN DE 

JF CHL) 
- To address in BC 

TRANS: LD H,B *ENTRY POINT IN BC 
LO L. & 
IP CHL) 

or 

TRANS: PUSH BC *ENTRY POINT IN EC 

RET 


The second alternative is longer, but leaves HL unchanged. 


- To address in memory locations ADDR and ADDR+1 


TRANS: LO HL, (ADDR) :sENTRY FOINT AT ADDR 
iF CHL. > 
- To address at the top of the stack. Here we must exchange the return address 
with the top of the stack. This can be done in the main program as follows: 


LO HL,RETPT ;GET RETURN POINT ADDRESS 
EX HL, (SP) sPUT RETURN ADDRESS ON STACK 
JF CHL) SAND JUMP TQ OLD TOP OF STACK 

The exchange can allow later resumption of a suspended program or provide a 
special exit to an error-handling routine. 

You can implement indexed calls in the same way as indirect calls. The CALL 
instruction transfers control to a routine that performs an indexed jump as shown 
earlier. That routine ends with an ordinary jump instruction (typically JP (HL)) that 
does not affect the stack. An RET instruction at the end of the actual subroutine will 
therefore transfer control back to the original calling point. 

If the main program executes CALL JMPIND with the index in the accumulator 
and the starting address of the jump table in register pair HL, the indexed jump routine 
1S 


JMPINE: Ann A,A sDQUBLE INDEX FOR 2-BYTE ENTRIES 
LD E,A ‘EXTEND INDEX TQ 14 BITS 
LO 0,0 
ADD HL, DE sCALCULATE ADDRESS QF ELEMENT 
LD E, CHL?) sFETCH ELEMENT FROM ADDRESS TABLE 
INC. HL 
LO D, CHL> 
EX DE, HL sAND JUMP TO IT 
JP CHL) 


One problem with indexed and indirect calls is that the transfer routines may 
interfere with the subroutines. For example, the indexed jump routine JMPIND 
changes the accumulator, register pair DE, register pair HL, and the flags. Thus, none 
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of these registers can be used to pass parameters to the subroutine. The programmer 
must always remember that the intermediate transfer routines are interposed between 
the main program and the actual subroutine. A similar interposition occurs when 
operating system routines transfer control from one task to another or from a main 
program to an I/O driver or an interrupt service routine. 


Conditional Call Instructions 


Conditional calls can be implemented on the Z80 by using the sequences shown for 
conditional branches. The only change is that jumps to the actual destination must be 
replaced with calls (for example, replace JR NZ,DEST with CALL NZ,DEST or JP 
P,DEST with CALL P,DEST). 


SUBROUTINE RETURN INSTRUCTIONS 


Unconditional Return Instructions 


The RET instruction returns control automatically to the address saved at the top of 
the stack. If the return address is saved elsewhere (for example, in a register pair or in 
two fixed memory locations) you can transfer control to it by performing an indirect 
jump. 


Conditional Return Instructions 


Conditional returns can be implemented on the Z80 microprocessor by using the 
sequences shown earlier for conditional branches. The only change is that you must 
replace jumps to the actual destination with RETs (for example, replace JR NC, DEST 
with RET NC or JP M,DEST with RET M). 


Return with Skip Instructions 


- Return control to the address at the top of the stack after it has been 
incremented by an offset NEXT. This sequence lets you transfer control past 
parameters, data, and other non-executable items. 


POP DE 7;GET RETURN ADDRESS 
LD HL, NEXT sOFFSET TO NEXT EXECUTABLE INSTRUCTION 
ADO HL,DE 


uIP CHL) 3;AND RETURN 
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- Change the return address to RETPT. Assume that the return address is 
currently stored at the top of the stack. 
LD HL, RETPT sCHANGE RETURN ADDRESS TQ RETPT 
EX HL., (SP) 
EX HL,(SP) exchanges HL with the top of the stack. This procedure allows you to 
force a special exit to an error routine or other exception-handling program without 
changing the logic of the subroutine or losing track of the original return address. 


Return from Interrupt Instructions 


If the initial portion of the interrupt service routine saves all the primary registers 
and the index registers with the sequence 


PUSH AF sSAVE PRIMARY REGISTERS 
PUSH BC 

PUSH DE 

PUSH HL 

PUSH IX sSAVE INDEX REGISTERS 
PUSH IY 


a Standard return sequence is 


POF IY sRESTORE INDEX REGISTERS 
POF IX 

POF HL sRESTORE PRIMARY REGISTERS 
POF DE 

FOF EBC 

POF AF 

EI sREENABLE INTERRUFTS 

RETI 


The order of restoration is the opposite of the order in which the registers were 
saved. The instruction EI must come immediately before RETI to avoid unnecessary 
stacking of return addresses. 


MISCELLANEOUS INSTRUCTIONS 


In this category, we include no operations, push, pop, halt, wait, trap (break or 
software interrupt), decimal adjust, enabling and disabling of interrupts, translation 
(table lookup), and other instructions that do not fall into any of the earlier categories. 


1. No Operation Instructions. 


Like NOP itself, any LD instruction with the same source and destination register 
does nothing except advance the program counter. These additional no-ops are 
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LO A,A 
Lo B,B 
LD c,c 
Lo 0,D 
LD E,E 
Lo H,H 
Lo Lb 


2. Push Instructions. 


- Push a single register (A, B, D, or H) 


PUSH rp >PUSH THE REGISTER PAIR 
INC SP ;BUT DROP THE LESS SIGNIFICANT HALF 


The register pair could be AK Programmers generally prefer to combine byte-length 
operands or simply waste a byte of the stack rather than attempt to push a single byte. 


- Push memory location ADDR 


LD A, (ADDR) 7;QBTAIN, DATA FROM MEMORY 
PUSH AF 7;FUSH DATA, FLAGS 
INC SPF 7 THEN DROP THE FLAGS 


ADDR could be an external priority or control register (or a copy of an external 
register). 
- Push memory locations ADDR and ADDR+1 


LD HL, (ADDR) *PUSH A PAIR OF MEMORY LOCATIONS 
PUSH HL 


- Push the interrupt flip-flop IFF2 


Lo A,I ;MQVE IFF2 TO PARITY/OVERFLOW FLAG 
PUSH AF 


This sequence allows you to save the interrupt status in the Parity / Overflow flag (bit 
2 of register F) for later restoration. 


3. Pop (Pull) Instructions. 
- Pop a single register (A, B, D, or H), assuming that it has been saved as shown 
previously 


DEC SP 7;BACK UP THE STACK POINTER 
POP rp ;POF THE REGISTER PAIR 


This sequence changes the less significant half of the register pair unpredictably. 


- Pop memory location ADDR, assuming that it has been saved at the top of the 
stack 


DEC SP ;BACK UF THE STACK POINTER 
POF AF 7;POP ACCUMULATOR AND FLAGS 


LD (ADDR) ,A 7;RESTORE DATA TO MEMORY 
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This sequence changes the flags unpredictably. ADDR could be an external priority 
or control register (or a copy of an external register). 
- Pop memory locations ADDR and ADDR+1, assuming that they were saved as 
shown previously 


POF HL ;RESTORE A PAIR OF MEMORY LOCATIONS 
LO CADDR), HL 


Sometimes you must push and pop key memory locations and other values beside the 
registers. 


- Restore interrupt status, assuming that it has been saved at the top of the stack. 


POP AF ?OBTAIN PREVIQUS INTERRUPT STATUS 
JF PE, ENABLE 
DI DISABLE INTERRUPTS IF PREVIOUSLY SO 
JR DONE 
ENABLE : EI sENABLE INTERRUPTS IF PREVIQUSLY SO 
DONE: NOP 


The interrupt flip-flop IFF2 is saved in the Parity/Overflow flag; interrupts were 
previously enabled if that flag is 1 and disabled if it is 0. 


Wait Instructions 


The simplest way to implement a wait on the Z80 microprocessor is to use an endless 
loop such as 


HERE : JF HERE 


The processor will execute JP until it is interrupted and will resume executing it after 
the interrupt service routine returns control. Of course, regular interrupts must have 
been enabled (with E]) or the processor will execute the endless loop indefinitely. The 
non-maskable interrupt can interrupt at any time without being enabled. 


Trap Instructions 


The common Z80 traps (also called breaks or software interrupts) are the RST 
instructions (see the list in Table 1-9). RST n calls the subroutine starting at address n. 
Thus, for example, RST 0 transfers control to memory address 0000 after saving the 
current program counter in the stack. Similarly, RST 30H transfers control to memory 
address 003016 after saving the current program counter in the stack. The interrupt 
system generally uses the RST instructions, but the programmer can dedicate unused 
ones to common subroutines, error traps, or supervisor entry points. RST then serves 
as a 1-byte call. 
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Adjust Instructions 


1. Branch if accumulator does not contain a valid decimal (BCD) number. 


LO reg,A 7SAVE COPY OF ACCUMULATOR 

Ano A,O 7THEN DECIMAL ADJUST ACCUMULATOR 
DAA 

CMP reg 7;DID DECIMAL ADJUST CHANGE A? 

UR NZ, DEST 7YES, A WAS NOT DECTMAL 


2. Decimal increment accumulator (add 1 to A in decimal). 


Ann A,1 s;ADD 12 IN DECIMAL 
DAA 


3. Decimal decrement accumulator (subtract 1 from A in decimal). 


SUB 1 SUBTRACT 1 IN DECIMAL 
DAA 

Or 
ADD A,99H SUBTRACT 1 BY ADDING 99? 
DAA 


The second alternative is compatible with the 8080 and 8085 processors, where DAA 
works properly only after addition instructions. 


Enable and Disable Interrupt Instructions 


1. Enable interrupts but save previous value of interrupt flip-flop 2 (the interrupt 
status). 


LD A,I ;MOVE INTERRUPT FLIP-FLOP TO F/V FLAG 
PUSH AF ;SAVE OLD IFF2 IN STACK 
EI 7 THEN ENABLE INTERRUPTS 


2. Disable interrupts but save previous value of interrupt flip-flop 2 (the interrupt 
Status). 


LD A,I ;MQVE INTERRUPT FLIP-FLOP TQ P/V FLAG 
PUSH AF 7;SAVE OLD IFF2 IN STACK 
DI 7THEN DISABLE INTERRUPTS 


3. Restore interrupt status, assuming that it is currently saved in the Parity/ 
Overflow flag at the top of the stack. 


POF AF OBTAIN PREVIOUS INTERRUPT STATUS 
UIP PE, ENABLE ;WERE INTERRUPTS ENABLED ORIGINALLY? 
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DI 7;NQ, THEN DISABLE THEM NOW 
AR NONE 
ENABLE: EI 7YES, THEN ENABLE THEM NUW 
DONE : NOP 


After LD A,Ilor LD A,R, JP PE means “branch if interrupts are enabled,” while JP 
PO means “branch if interrupts are disabled.” 


Translate Instructions 


1. Translate the accumulator into the corresponding entry in a table starting at the 
address in register pair HL. 


LD E,A s;EXTEND QPERAND TO 14-BIT INDEX 
Lo n,9O 

ADD HL,DE FUSE OPERAND TO ACCESS TABLE 

LO A, CHL) 7;REPLACE OPERAND WITH TABLE ENTRY 


This procedure can be used to convert data from one code to another. 


2. Translate the accumulator into the corresponding 16-bit entry in a table starting 
at the address in register pair HL. Place the entry in HL. 


EX DE, HL ;MOVE STARTING ADDRESS TQ DE 

LD L,A 7;EXTEND OQPERAND TO 146-BIT INDEX 
LD H,O 

ADD HL,HL DOUBLE INDEX FOR 2-BYTE ENTRIES 
ADD HL,DE s;CALCULATE INDEXED ADDRESS 

LD E, (HL) ;OQBTAIN ENTRY 

INC HL 

LD Di, CHL) 

EX DE, HL ;MOVE ENTRY TQ HL 


Using ADD HL,HL to double the operand allows it to take on any 8-bit value (using 
ADD A,A would limit us to values below 128). 


Miscellaneous Instructions 


1. Allocate space on the stack; decrease the stack pointer to provide NUM empty 
locations at the top. 
LO HL, —-NLIM sADOQ NUM EMPTY BYTES TQ TOP OF STACK 
ADD HL,SP 
LO SP, HL 3SP = SP — NUM 


An alternative is a series of DEC SP instructions. 


2. Deallocate space from the stack; increase the stack pointer to remove NUM 
temporary locations from the top. 
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LO HL, NUM ;DELETE NUM BYTES FROM STACK 
ADD HL,SP 
LO SP, HL 7;SF = SP + NUM 


An alternative is a series of INC SP instructions. 


ADDITIONAL ADDRESSING MODES 


- Indirect Addressing. Indirect addressing can be provided on the Z80 processor by 
loading the indirect address into register pair HL. Then addressing through HL 
provides the equivalent of true indirect addressing. This is a two-step process that 
generally requires HL, although BC or DE can be employed to load and store the 
accumulator. The index registers may also be used, although at the cost of extra 
execution time and memory. Note that indexed addressing with a 0 offset is simply a 
slow version of indirect addressing. 


Examples 


1. Load the accumulator indirectly from the address in memory locations ADDR 
and ADDR-+1. 


LD HL, (ADDR) 7;FETCH INDIRECT ADDRESS 

LD A, CHL) 7;FETCH DATA INDIRECTLY 
or 

LD xy, CADDR) ;FETCH INDIRECT ADDRESS 

LD A, (xyt+0) 7;FETCH DATA INDIRECTLY 


2. Store the accumulator indirectly at the address in memory locations ADDR and 
ADDR-+ 1. 


LD HL, (ADDR) 7;FETCH INDIRECT ADDRESS 

LD CHLI,A ;STORE DATA INDIRECTLY 
Or 

LD xy, (ADDR) 7;FETCH INDIRECT ADDRESS 

LD CxytO),4 7;STORE DATA INDIRECTLY 


3. Load the accumulator indirectly from the address in register pair HL (that is, 
from the address stored starting at the address in HL). 


LD E, (HL) FETCH INDIRECT ADDRESS 
INC HL 
LD D, CHL) 


LD A, (DE) 7FETCH DATA INDIRECTLY 
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4. Load the accumulator indirectly from the address in an index register (that is, 
from the address stored starting at the address in an index register). 


LO L, (xyt#0) sFETCH INDIRECT ADDRESS 
LO H, (xyt1) 
LO A, CHL) sFETCH DATA INDIRECTLY 


5. Store the accumulator indirectly at the address in register pair HL (that is, at the 
address stored starting at the address in HL). 


LD E, CHL) ‘FETCH INDIRECT ADDRESS 
INC HL 

LO QD, CHL) 

LD (DE),A STORE DATA INDIRECTLY 


6. Store the accumulator indirectly at the address in an index register (that is, at the 
address stored starting at the address in an index register). 


Lo L, (xy+t#0) sFETCH INDIRECT ADDRESS 
LO H, (xyt1) 
LN CHL),A *STORE DATA INDIRECTLY 


7. Jump indirectly to the address in memory locations ADDR and ADDR+1. 


LO HL, (ADDR) 7;FETCH INDIRECT ADDRESS 

UP CHL) ;AND TRANSFER CONTROL TO IT 
Or 

LO xy, CADDR) sFETCH INDIRECT ADDRESS 

JP ixy) s;AND TRANSFER CONTROL TQ IT 


Indirection can be repeated indefinitely to provide multi-level indirect addressing. For 
example, the following routine uses the indirect address indirectly to load the 
accumulator: 


LO E, (HL) sFETCH FIRST INDIRECT ADDRESS 
INC HL 

Ln 0, CHL) 

EX DE, HL 

LO E, (HL) SUSE INDIRECT ADDRESS INDIRECTLY 
INC: HL 

LO 0, CHL) 

Lo A, (DE) sFETCH DATA INOIRECTLY 


Indirect addresses should be stored in memory in the usual Z80 format—that is, with 
the less significant byte first (at the lower address). 


- Indexed Addressing. Indexed addressing can be provided by using ADD HL to 
add the base and the index. Obviously, the explicit addition requires extra execution 
time. The index registers are useful when the index is fixed (as in a data structure) or 
when HL 1s already occupied. 
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Examples 


1. Load the accumulator from an indexed address obtained by adding the accumu- 
lator to a fixed base address. 


LD DE, BASE 7;GET BASE ADDRESS 

LO LA s;EXTEND INDEX Ta 14 BITS 

LO H,0O 

ADD HL, DE F;CALCULATE INDEXED ADDRESS 

LD A, CHL) 7;FETCH DATA FROM INDEXED ADDRESS 


2. Load the accumulator from an indexed address obtained by adding the accumu- 
lator to memory locations BASE and BASE+1. 


LD HL, (BASE) 7;GET BASE ADDRESS 

LO E,A ;EXTEND INDEX TO 16 BITS 

LO 0,0 

ADD HL, DE FCALCULATE INDEXED ADDRESS 

LO A, CHL) ;FETCH DATA FROM INDEXED ADDRESS 


3. Load the accumulator from an indexed address obtained by adding memory 
locations INDEX and INDEX-+1 to register pair HL. 


LD DE, (INDEX) 7;GET INDEX FROM MEMORY 
ADD HL, DE 7;CALCULATE INDEXED ADDRESS 
LD A, CHL) ;FETCH DATA FROM INDEXED ADDRESS 


4. Jump indexed to a jump instruction in a list. The index is in the accumulator and 
the base address of the list is in register pair HL. 


LD B,A MULTIPLY INDEX TIMES 3 
ADD A,A 
ADD B,A 
LO C,A 7;EXTEND INDEX TO 16 BITS 
LD E,O 
ADD HL,BC ;CALCULATE INDEXED ADDRESS 
uIP CHL) 7;AND TRANSFER CONTROL THERE 
The following is a typical list starting at address BASE: 

BASE: JP SUBO JUMP TO SUBROUTINE oO 
uP SUB1 JUMP TQ SUBROUTINE 1 
JP SUB2 sJUMP TO SUBROUTINE 2 


Since each JP instruction occupies three bytes, we must multiply the index by 3 before 
adding it to the base address. If the list is more than 256 bytes long, we can use the 
following procedure to multiply the index by 3: 


EX DE, HL 7;SAVE BASE ADDRESS IN DE 
Lo LA EXTEND INDEX TO 16 BITS 
LD H,9O 


LD B,L ;COFY INDEX INTO BC 
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Ln C,H 

ADD HL,HL ;DOQUBLE INDEX 

ADD HL,BC 7; TRIPLE INDEX 

AnD HL,DE sCALCULATE INDEXED ADDRESS 
uP CHL > ;AND TRANSFER CONTROL THERE 


- Autopreincrementing. In autopreincrementing, the address register is incre- 
mented automatically before it is used. Autopreincrementing can be provided on the 
Z80 by incrementing a register pair before using it as an address. 


Examples 


- Load the accumulator using autopreincrementing on register pair HL. 


INC HL 7;AUTOPRE INCREMENT HL 
LD A, CHL) ;FETCH DATA 


- Store the accumulator using autopreincrementing on register pair DE. 


INC DE ;AUTOPREINCREMENT DE 
LD (DE),A 7;STORE DATA 


- Load register pair DE starting at the address two larger than the contents of HL. 


INC HL sAUTOPREINCREMENT HL BY 2 
INC HL 

LO E, CHL) sFETCH LSB 

ING HL 

LD D, CHL) sFETCH MSB 


Autoincrementing by 2 is essential in handling arrays of addresses or 16-bit data 
items. 


- Store the accumulator using autopreincrementing on memory locations ADDR 
and ADDR+1. 


LO HL, (ADDR) ;AUTOPREINCREMENT INDIRECT ADDRESS 


INC HL 
LD C(HLD,A 7STORE DATA 
LO (ADDR), HL 7;UPDATE INDIRECT ADDRESS 


Autopreincrementing can be combined with indirection. Here memory locations 
ADDR and ADDR-+ 1 could point to the last occupied location in a buffer. 


- Transfer control to the address stored starting at an address two larger than the 
contents of memory locations NXTPGM and NXTPGM+1. 


LO HL, (NXTPGM) ©GET POINTER 

INC WL sALUITTOPREINCREMENT POINTER 
INC HL 

LD CNXTPGM) , HL sUPDATE POINTER 

LD E, CHL) sFETCH STARTING ADDRESS 


INC HL 
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LD DQ, CHL) 
EX DE, HL 7AND TRANSFER CONTROL TO IT 
IP CHL) 


Here NXTPGM and NXTPGM-+1 point to the starting address of the routine that 
the processor has just executed. Initially, NXTPGM and NXTPGM-+1 would contain 


BASE-2, where BASE is the starting address of a table of routines. A typical table 
would be 


BASE: DW ROUTO FSTARTING ADDRESS FOR ROUTINE O 
OW ROUT 1 7STARTING ADDRESS FOR ROUTINE 1 
DW ROUT2 ;STARTING ADDRESS FOR ROUTINE 2 
DW ROUTS 7STARTING ADDRESS FOR ROUTINE 3 


- Autopostincrementing. In autopostincrementing, the address register is incre- 
mented after it is used. Autopostincrementing can be provided on the Z80 by 
incrementing a register pair after using it as an address. Note that the Z80 autopostin- 
crements the stack pointer when it executes POP and RET. 


Examples 


- Load the accumulator using autopostincrementing on register pair HL. 


LD A, CHL) ;FETCH DATA 
INC HL FAUTOPOSTINCREMENT HL 


* Store the accumulator using autopostincrementing on register pair DE. 


LD (DE),A ;STORE DATA 
INC DE 7;AUTOPOSTINCREMENT DE 


- Load register pair DE starting at the address in HL. Then increment HL by 2. 


LD E, CHL) sFETCH LSB 
INC HL 
LD OD, (HL) sFETCH MSB 
ING HL 


Autoincrementing by 2 is essential in handling arrays of addresses or 16-bit data 


items. Note that postincrementing is generally simpler and more natural than 
preincrementing. 


- Store the accumulator using autopostincrementing on memory locations ADDR 
and ADDR-+1. 


LD HL, (ADDR) 7FETCH INDIRECT ADDRESS 
LD CHL), A 7;STORE DATA 
INC HL 7;AUITOPOSTINCREMENT INDIRECT ADDRESS 


LD (ADDR), HL 


- Autopostincrementing can be combined with indirection. Here memory locations 
ADDR and ADDR-+1 could point to the next empty location in a buffer. 
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- Transfer control to the address stored at the address in memory locations 
NXTPGM and NXTPGM-+1. Then increment those locations by 2. 


LOD HL, (NXTPGM) 


LO E, (HL) sFETCH STARTING ADDRESS 

INC WL 

LD D, CHL) 

INC HL sCOMPLETE AUTOPOSTINCREMENT 

LO CNXTPGM), HL 

EX DE, HL s; TRANSFER CONTROL TO START ADDRESS 
UP CHL > 


Here NXTPGM and NXTPGM+ I point to the starting address of the next routine 
the processor is to execute. Initially, NXTPGM and NXTPGM-+1 would contain 
BASE, the starting address of a table of routines. A typical table would be 


BASE: DW ROUTO STARTING ADDRESS FOR ROUTINE O 
DW ROUT 1 ?STARTING ADDRESS FOR ROUTINE 1 
DW ROUT2 7STARTING ADDRESS FOR ROUTINE 2 
DW ROUTS 7STARTING ADDRESS FOR ROUTINE 3 


- Autopredecrementing. In autopredecrementing, the address register is decre- 
mented automatically before it is used. Autopredecrementing can be provided on the 
Z80 processor by decrementing a register pair before using it as an address. Note that 
the processor autopredecrements the stack pointer when it executes PUSH and 
CALL. 


Examples 
- Load the accumulator using autopredecrementing on register pair HL. 


DEC HL ;AUITOPREDECREMENT HL 
LO A, (HL) sFETCH DATA 


- Store the accumulator using autopredecrementing on register pair DE. 


DEC DE sAUTOPREDECREMENT DE 
LD (DE),A ;STORE DATA 


- Load register pair DE starting at the address two smaller than the contents of HL. 


DEC HL s;FETCH MSB 
LD DQ, CHL) 
DEC HL ;FETCH LSB 
LO E, CHL) 


Autodecrementing by 2 is essential in handling arrays of addresses or 16-bit data 
items. Note that predecrementing is generally simpler and more natural than 
postdecrementing. 


- Store the accumulator using autopredecrementing on memory locations ADDR 
and ADDR-+1. 
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LoD HL, (ADDR) ;ALITOPREINCREMENT INDIRECT ADDRESS 
DEC HL 

LD CHLI,A ;STORE DATA 

LD (ADDR), HL F;UPDATE INDIRECT ADDRESS 


Autodecrementing can be combined with indirection. Here memory locations ADDR 
and ADDR+1 could point to the last occupied location in a stack. 


- Transfer control to the address stored at an address two smaller than the contents 
of memory locations NXTPGM and NXTPGM+1. 


LD HL, (NXTPGM) 7;FETCH STARTING ADDRESS 

DEC HL 

LD D, CHL) 

DEC HL 

LD E, CHL) 

LO (NXTPGM) , HL 7; STORE AUTOPREDECREMENTED POINTER 
EX DE, HL 7 TRANSFER CONTROL TO START ADDRESS 
JF CHL > 


Here NXTPGM and NXTPGM-+1 point to the starting address of the most recently 
executed routine in a list. Initially, NXTPGM and NXTPGM-+1 would contain 
FINAL+2, where FINAL is the address of the last entry in a table of routines. A 
typical table would be 


ARTING ADDRESS FOR ROUTINE O 


DW =RQUTO 7ST 
SSTARTING ADDRESS FOR ROUTINE 1 


DW ROUT 1 


FINAL: DW ROUTL s;STARTING ADDRESS FOR LAST ROUTINE 


Here we work through the table backward. This approach is useful in evaluating 
mathematical formulas entered from a keyboard. If, for example, the computer must 
evaluate the expression 


Z= LN (A x SIN (B x EXP(C x Y))) 


it must work backward. That is, the order of operations is 


> Calculate C x Y 

- Calculate EXP (C x Y) 

- Calculate B x EXP(C x Y) 

- Calculate SIN (B x EXP(C x Y)) 

- Calculate A x SIN (B x EXP(C x Y)) 

- Calculate LN(A x SIN(B x EXP(C x Y))). 


Working backward is convenient when the computer cannot start a task until it has 
received an entire line or command. It must then work back to the beginning. 
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- Autopostdecrementing. In autopostdecrementing, the address register is decre- 
mented automatically after it is used. Autopostdecrementing can be implemented on 
the Z80 by decrementing a register pair after using it as an address. 


Examples 


- Load the accumulator using autopostdecrementing on register pair HL. 


LD A, CHL) 7;FETCH DATA 
DEC HL 7;AUITOPOSTDECREMENT HL 


- Store the accumulator using autopostdecrementing on register pair DE. 


LD (DE),A 7;STQRE DATA 
DEC DE F;ALITOPOSTOECREMENT DE 


- Load register pair DE starting at the address in HL. Afterward, decrement HL 
by 2. 


INC HL ©FETCH MSB 

LD DO, CHL) 

DEC HL sFETCH LSB 

LD E, CHL) 

DEC HL sAUTOPOSTDECREMENT HL BY 2 
NEC HL 


Autodecrementing by 2 is essential in handling arrays of addresses or 16-bit data items. 


- Store the accumulator using autopostdecrementing on memory locations ADDR 
and ADDR+1. 


LD HL, (ADDR) sFETCH INDIRECT ADDRESS 
LD CHL)I,A ;STQORE DATA 
DEC HL F;AUTOPOSTOECREMENT INDIRECT ADDRESS 


LD (ADDR) , HL 


Autopostdecrementing can be combined with indirection. Here memory locations 
ADDR and ADDR-+1 could point to the next empty location in a buffer. 


- Transfer control to the address stored at the address in memory locations 
NXTPGM and NXTPGM + 1. Then decrement those locations by 2. 


LD HL, (NXTPGM) 3;FETCH POINTER 

INC HL 7;FETCH STARTING ADDRESS 

LD D, CHL) 

DEC HL 

LD E, CHL) 

DEC HL ;AUTOPOSTDECREMENT POINTER 
DEC HL 

LD CNXTPGM), HL 

EX DE, HL JUMP TO STARTING ADDRESS 
IP CHL) 


Here NXTPGM and NXTPGM-+ 1 point to the starting address of the next routine 
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the processor is to execute. Initially, NXTPGM and NXTPGM-+1 contain FINAL, 
the address of the last entry in a table of routines. A typical table would be 


DW ROUTO sSTARTING ADDRESS OF ROUTINE O 
DW ROUT 1 sSTARTING ADDRESS OF ROUTINE 1 
FINAL: DW ROUTL SSTARTING ADDRESS OF LAST ROUTINE 


Here the computer works through the table backward. This approach is useful in 
interpreting commands entered in the normal left-to-right manner from a keyboard. 
For example, assume that the operator of a process controller enters the command 
SET TEMP(POSITION 2) = MEAN(TEMP(POSITION 1), TEMP(POSITION 3)). 
The controller program must execute the command working right-to-left and starting 
from inside the inner parentheses as follows: 


1. Determine the index corresponding to POSITION 1. 
2. Obtain TEMP(POSITION 1) from a table of temperature readings. 
3. Determine the index corresponding to POSITION 3. 
4. Obtain TEMP(POSITION 3) from a table of temperature readings. 


5. Evaluate MEAN(TEMP(POSITION 1), TEMP(POSITION 3)) by executing 
the MEAN program with the two entries as data. 


6. Determine the index corresponding to POSITION 2. 


7. Execute the SET function, which presumably involves setting controls and 
parameters to achieve the desired value of TEMP (POSITION 2). 


The operator enters the command working left to right and from outer parentheses 
to inner parentheses. The computer, on the other hand, must execute it inside out 
(starting from the inner parentheses) and right to left. Autodecrementing is obviously 
a handy way to implement this reversal. 


- Indirect preindexed addressing (preindexing). In preindexing, the processor 
must first calculate an indexed address and then use that address indirectly. Since the 
indexed table must consist of 2-byte indirect addresses, the indexing must involve a 
multiplication by 2. 


Examples 


- Load the accumulator using preindexing. The base address is in an index register 
and the index is a constant INDEX. 


LD L, (xy+22 INDEX) sQBTAIN LSB OF ADDRESS 
LD H, (xy +22 INDEX+1) sQBTAIN MSB OF ADDRESS 


LD A, CHL) sQBTAIN DATA INDIRECTLY 
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Because of the limitations of Z80 indexing, this approach works only when INDEX isa 
constant. 


- Load the accumulator using preindexing. The base address is in register pair HL 
and the index is in the accumulator. 


ADD A,A ;DQUBLE INDEX FOR 2-BYTE ENTRIES 
LD E,A s;EXTEND INDEX TO 16 BITS 

LD 0,0 

ADD HL, DE F;CALCULATE INDEXED ADDRESS 

LD E, CHL) 7QBTAIN INDIRECT ADDRESS 

INC HL 

LD Ci, CHL) 

LD A, (DE) OBTAIN DATA INDIRECTLY 


- Store the accumulator using preindexing. The base address is in memory locations 
ADDR and ADDR-1 and the index is a constant INDEX. 


LD xy, CADDR) 7;QOBTAIN BASE ADDRESS 

LD L, (xy+22 INDEX) ?QOBTAIN INDIRECT ADDRESS 
LD H, (xy+22 INDEX+1) 

LD CHL),A 7STORE DATA INDIRECTLY 


- Store the accumulator using preindexing. The base address is in memory locations 
ADDR and ADDR-+1 and the index is in memory location INDEX. 


LO HL, (ADDR) sFETCH BASE ADDRESS 

LO B,A SAVE DATA 

LO A, CINDEX) ;FETCH INDEX 

ADD A,A ;ROUBLE INDEX FOR 2-BYTE ENTRIES 
LO E,A sEXTEND INDEX Ta 14 BITS 
Lo 0,o 

ADD HL, DE sCALCULATE INDEXED ADDRESS 
LD E, (HL) *QBTAIN INDIRECT ADDRESS 
INC HL 

Lo 0D, CHL) 

EX DE, HL :STORE DATA INDIRECTLY 

LO (HL),B 


- Transfer control (jump) to the address obtained indirectly from the table starting 
at address JTAB. The index is in the accumulator. 


ADD A,A ;DOUBLE INDEX FOR 2-BYTE ENTRIES 
LD E,A 7;EXTEND INDEX TO 14 BITS 

LD 0,90 

LD HL, JITAB 7;GET BASE ADDRESS 

ADD HL,DE 7CALCULATE INDEXED ADDRESS 

LD E, CHL) OBTAIN INDIRECT ADDRESS 

INC HL 

LD D0, CHL) 

EX DE, HL 7;JUMP TO INDIRECT ADDRESS 


JP CHL >) 
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The table starting at address JTAB would appear as follows: 


JTAB: DW ROUTO sSTARTING ADDRESS GF ROUTINE O 
DW ROUT 1 sSTARTING ADDRESS OF ROUTINE 1 
DW ROUT 2 FSTARTING ADDRESS OF ROUTINE 2 


- Indirect postindexed addressing (postindexing). In postindexing, the processor 
must first obtain an indirect address and then apply indexing with that address as the 
base. Thus the indirect address tells the processor where the table or array starts. 


Examples 


- Load a register using postindexing. The base address is in memory locations 
ADDR and ADDR-+1 and the index is a constant OFFSET: 
LO xy, (ADDR) ;QBTAIN BASE ADDRESS INDIRECTLY 
LO reg, (xytOFFSET);QBTAIN DATA 


This approach is useful when ADDR and ADDR-+1 contain the base address of a 
data structure and OFFSET is the fixed distance from the base address to a particular 
data item. 


- Load the accumulator using postindexing. The base address is in memory loca- 
tions ADDR and ADDR+1 and the index is in the accumulator. 


LD HL, (ADDR) sOBTAIN BASE ADDRESS INDIRECTLY 
LD E,A sEXTEND INDEX TO 16 BITS 

LO 0,0 

ADD HL, DE s;CALCULATE INDEXED ADDRESS 

LD A, CHL) s;QBTAIN DATA 


- Store a register using postindexing. The base address is in memory locations 
ADDR and ADDR-+1 and the index is a constant OFFSET: 


LD xy, CADDR) ;QBTAIN BASE ADDRESS INDIRECTLY 
LD (xytOFFSET),reg;STORE DATA POSTINDEXED 


- Store the accumulator using postindexing. The base address is in memory loca- 
tions ADDR and ADDR+1 and the index is in memory location INDEX. 


LD HL, (ADDR) sOQBTAIN BASE ADDRESS INDIRECTLY 
Lo B,A ;SAVE DATA 

LD A, CINDEX) ;QBTAIN INDEX 

LO E,A s;EXTEND INDEX TO 16 BITS 

LD n,o 

ADD HL, DE sCALCULATE INDEXED ADDRESS 

LD CHL)D,B 7;STORE DATA 


By changing the contents of memory locations ADDR and ADDR-+ 1, we can make 
this routine operate on many different arrays. 
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- Transfer control (jump) to the address obtained by indexing from the base address 
in memory locations ADDR and ADDR+1. The index is a constant OFFSET. 
LD xy, CADDR) s;QBTAIN BASE ADDRESS INDIRECTLY 
LD L,(xy+tOFFSET) ;OQBTAIN LSB OF DESTINATION 
LD 4H, (xy+OFFSET+1);QBTAIN MSB OF DESTINATICN 
JP CHL) 7;JUMP TO DESTINATION 
This procedure is useful when a data structure contains the starting address of a 
routine at a fixed offset. The routine could, for example, be a driver for an I/Ocontrol 
block, an error routine for a mathematical function, or a control equation for a process 
loop. 


- Transfer control (jump) to the address obtained by indexing from the base address 
in memory locations ADDR and ADDR-+1. The index is in the accumulator. 


LO B,A TRIPLE INDEX FOR 3-BYTE ENTRIES 
ADD A,A 

ADD A,B 

LO E,A s;EXTEND INDEX TO 16 BITS 

LO D,O 

LD HL, (ADDR) ;QBTAIN BASE ADDRESS INDIRECTLY 
ADD HL, DE CALCULATE INDEXED ADDRESS 

JP CHL) sAND TRANSFER CONTROL TO IT 


The table contains 3-byte JP instructions; a typical example is 


BASE: JP ROUTO 7;JUMP TQ ROUTINE 0 
JP ROUT 1 ;JUMP TO ROUTINE 1 
JP ROUT2 ;JUMP TO ROUTINE 2 


The address BASE must be placed in memory locations ADDR and ADDR-+1. 
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Charcter3 Common Programming 
Errors 


This chapter describes common errors in Z80 assembly language programs. The 
final section describes common errors in input/output drivers and interrupt service 
routines. Our aims here are the following: 


- To warn programmers of potential trouble spots and sources of confusion. 
- To describe likely causes of programming errors. 
- To emphasize the techniques and warnings presented in Chapters | and 2. 


- To inform maintenance programmers of likely places to look for errors and 
misinterpretations. 


- To provide the beginner with a starting point in the difficult process of locating 
and correcting errors. 


Of course, no list of errors can be complete. Only the most common errors are 
emphasized — not the infrequent or subtle errors that frustrate even the experienced 
programmer. However, most errors are remarkably obvious once uncovered, and this 
discussion should help in debugging most programs. 


CATEGORIZATION OF PROGRAMMING ERRORS 


Common Z80 programming errors can be divided into the following categories: 


- Reversing the order of operands or parts of operands. Typical errors include 
reversing source and destination in load instructions, inverting the format in which 
16-bit quantities are stored, and inverting the direction of subtractions or comparisons. 
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- Using the flags improperly. Typical errors include using the wrong flag (such as 
Sign instead of Carry), branching after instructions that do not affect a particular flag, 
inverting branch conditions (particularly those involving the Zero flag), branching 
incorrectly in equality cases, and changing a flag accidentally before branching. 


- Confusing registers and register pairs. A typical error is operating on a register 
instead of on a register pair. 


- Confusing addresses and data. The most common error is omitting the paren- 
theses around an address and hence accidentally using immediate addressing instead 
of direct addressing. Another error is confusing registers or register pairs with the 
memory locations addressed via register pairs. 


- Using the wrong formats. Typical errors include using BCD (decimal) instead of 
binary, or vice versa, and using binary or hexadecimal instead of ASCII. 


- Handling arrays incorrectly. The usual problem is going outside the array’s 
boundaries. 


- Ignoring implicit effects. Typical errors include using the accumulator, a register 
pair, the stack pointer, flags, or memory locations without considering the effects of 
intervening instructions. Most errors arise from instructions that have unexpected, 
implicit, or indirect effects. 


- Failing to provide proper initial conditions for routines or for the microcomputer 
as a whole. Most routines require the initialization of counters, indirect addresses, base 
addresses, registers, flags, and temporary storage locations. The microcomputer as a 
~ whole requires the initialization of the interrupt system and all global RAM addresses. 
(Note particularly indirect addresses and counters.) 


- Organizing the program incorrectly. Typical errors include skipping or repeating 
initialization routines, failing to update counters or address registers, and forgetting to 
save intermediate or final results. 


A common source of errors that is beyond the scope of this discussion is conflict 
between user programs and systems programs. A simple example of conflict is for a 
user program to save data in memory locations that a systems program also uses. The 
user program’s data thus changes mysteriously whenever the systems program is 
executed. 

More complex sources of conflict include the interrupt system, input/output ports, 
the stack, and the flags. After all, systems programs must employ the same resources as 
user programs. Systems programs generally attempt to save and restore the user’s 
environment, but they often have subtle or unexpected effects. Making an operating 
system transparent to the user is a problem comparable to devising a set of regulations, 
laws, or tax codes that have no loopholes or side effects. 
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REVERSING THE ORDER OF OPERANDS 


The following instructions and conventions are the most common sources of errors: 


- The LD D;S instruction moves the contents of S to D. Reversing the source and 
the destination in LD instructions is probably the single most common error in Z80 
assembly language programs. The best way to avoid this problem is to use the operator 
notation described by Duncan.! 


- 16-bit addresses and data items are assumed to be stored with their less significant 
bytes first (that is, at the lower address). This convention becomes particularly confus- 
ing in instructions that load or store register pairs or use the stack. 


- The CP instruction subtracts its operand from the accumulator, not the other way 
around. Thus, CP sets the flags as if the processor had calculated (A) — OPER, where 
OPER is the operand specified in the instruction. 


Examples 


1. LD A,B 


This instruction loads the accumulator from register B. Since it does not change B, 
the instruction acts like “copy B into A.” 


2. LD (HL),A 


This instruction stores the accumulator at the memory address in register pair HL. 
Since it does not change the accumulator, the instruction acts like “copy A into 
memory addressed by HL.” 


3. LD (2040H),A 


The address 2040)¢ occupies the two bytes of program memory immediately follow- 
ing the operation code; 40;¢ comes first and 20;¢ last. This order is particularly 
important to remember when entering or changing an address at the object code level 
during debugging. 


4. PUSH HL 


This instruction stores register pair HL in memory at the addresses immediately 
below the initial contents of the stack pointer (that is, at addresses S-1 and S-2 if S is the 
initial contents of the stack pointer). Register H is stored at address S-1 and Lat S-2in 
the usual upside-down format. 


5. LD HL,(2050H) 
This instruction loads register L from memory address 205016 and H from 2051 6. 


442 280 ASSEMBLY LANGUAGE SUBROUTINES 


6. LD (3600H),HL 
This instruction stores register L at memory address 3600 ¢ and H at address 3601 j¢. 


7. CP B 


This instruction sets the flags as if register B had been subtracted from the 
accumulator. 


8. CP 25H 


This instruction sets the flags as if the number 25;¢ had been subtracted from the 
accumulator. 


USING THE FLAGS INCORRECTLY 


Z80 instructions have widely varying effects on the flags. There are few general rules, 
and even instructions with similar meanings may work differently. Cases that require 
special caution are 


- Data transfer instructions such as LD and EX (except EX AF, AF’) do not affect 
any flags. You may need an otherwise superfluous arithmetic or logical instruction 
(such as AND A, DEC, INC, or OR A) to set the flags. 


- The Carry flag acts as a borrow after CP, SBC, or SUB instructions; that is, the 
Carry is set if the 8-bit unsigned subtraction requires a borrow. If, however, you 
implement subtraction by adding the two’s or ten’s complement of the subtrahend, the 
Carry is an inverted borrow; that is, the Carry is cleared if the 8-bit unsigned 
subtraction requires a borrow and set if it does not. 


- After a comparison (CP), the Zero flag indicates whether the operands are equal; it 
is set if they are equal and cleared if they are not. There is an obvious source of 
confusion here — JZ means “jump if the result is 0,” that is, “jump if the Zero flag is 1.” 
JNZ, of course, has the opposite meaning. 


- When comparing unsigned numbers, the Carry flag indicates which number is 
larger. CP sets Carry if the accumulator is less than the other operand and clears it if the 
accumulator is greater than or equal to the other operand. Note that the Carry is 
cleared if the operands are equal. If this division of cases (“greater than or equal” and 
“less than”) is not what you want (that is, you want the division to be “greater than” and 
“less than or equal”), you can reverse the subtraction, subtract 1 from the accumulator, 
or add | to the other operand. 


- In comparing signed numbers, the Sign flag indicates which operand is larger. 
unless two’s complement overflow occurs (see Chapter 1). CP sets the Sign flag if the 
accumulator is less than the other operand and clears it if the accumulator is greater 
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than or equal to the other operand. Note that comparing equal operands clears the 
Sign flag. As with the unsigned numbers, you can handle the equality case in the 
opposite way by adjusting either operand or by reversing the subtraction. If overflow 
occurs (signified by the setting of the Parity/ Overflow flag), the sense of the Sign flag is 
inverted. 


- All logical instructions except CPL clear the Carry flag. AND A or OR A\1s, in 
fact, a quick, simple way to clear Carry without affecting any registers. CPL affects no 
flags at all (COR OFFH is an equivalent instruction that affects the flags). 


- The common way to execute code only if a condition is true is to branch around it 
if the condition is false. For example, to increment register B if Carry is 1, use the 
sequence 


JR NC, NEXT 
INC 8B 
NEXT: NOP 


The branch occurs if Carry is 0. 


- Many 16-bit arithmetic instructions have little effect on the flags. INC and DEC do 
not affect any flags when applied to register pairs or index registers; ADD HL and 
ADD xy affect only the Carry flag. The limited effects on the flags show that these 
instructions are intended for address arithmetic, not for the processing of 16-bit data. 
Note, however, that ADC HL and SBC HL affect all the flags and can be used for 
ordinary processing of 16-bit data. 


- INC and DEC do not affect the Carry flag. This allows them to be used for 
counting in loops that perform multiple byte arithmetic. (The Carry is needed to 
transfer carries or borrows between bytes.) The 8-bit versions of INC and DEC do, 
however, affect the Zero and Sign flags, and you can use those effects to determine 
whether a carry or borrow occurred. 


- The special instructions RLCA, RLA, RRCA, and RRA affect only the Carry 
flag. 


- Special-purpose arithmetic and logical instructions such as ADD A,A (logical left 
shift accumulator), ADC A,A (rotate left accumulator), SUB A (clear accumulator), 
and AND A or OR A (test accumulator) affect all the flags. 


- PUSH and POP instructions do not affect the flags, except for POP AF which 
changes all the flags. Remember, AF consists of the accumulator (MSB) and the flags 
(LSB). 


Examples 


1. The sequence 


LD A, (2040H) 
JR Z, DONE 
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has unpredictable results, since LD does not affect the flags. To produce a jump if 
memory location 2040 1¢ contains 0, use 


LD A, (2040H) 
AND A 7;TEST ACCUMULATOR 
JR Z, DONE 


OR A may be used instead of AND A. 
2. The sequence 


LD A,E 
JP F, DEST 


has unpredictable results, since LD does not affect the flags. Either of the following 
sequences forces a jump if register E is positive: 


LD A,E 

AND A 

JP P, DEST 
Or | 

SUB A 

OR Ee 


_ dP P, DEST 


3. The instruction CP 25H sets the Carry flag as follows: 
- Carry = | if the contents of A are between 00 and 24j¢. 
- Carry = 0 if the contents of A are between 25)¢ and FF jg. 


The Carry flag is set if A contains an unsigned number less than the other operand 
and is cleared if A contains an unsigned number greater than or equal to the other 
operand. 

If you want to set Carry if the accumulator contains 2516, use CP 26H instead of CP 
25H. That is, we have 


CP 25H 

JR C,LESS 7BRANCH IF (A) LESS THAN 25 
Or 

cP 26H 

IR C,LESSEQ ;BRANCH IF (A) 25 OR LESS 


4. The sequence 


RLA 
JP FP, DONE 


has unpredictable results, since RLA does not affect the Sign flag. The correct 
sequence (producing a circular shift that affects the flags) is 


ADC A,A sSHIFT CIRCULAR, SETTING FLAGS 
IP FP, DONE 
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Of course, you can also use the somewhat slower 


RLA 
RLA 
JR C, DONE 


This approach allows a relative branch. 
5. The sequence 


INC 6 
JR C, OVRFLW 


has unpredictable results, since INC does not affect the Carry flag. The correct 
sequence is 


INC B 
JR Z,QVRFLW 


since INC does affect the Zero flag when it is applied to an 8-bit operand. 


6. The sequence 
nec B 
JR C,QVRFLW 
has unpredictable results, since DEC does not affect the Carry flag. If B cannot contain 
a number larger than 80)6 (unsigned), you can use 
DEC B 
JP M, OVRFLW 
since DEC does affect the Sign flag (when applied to an 8-bit operand). Note, however, 
that you will get an erroneous branch if B initially contains 81 j¢. 
A longer but more general sequence is 


INC 6B ;TEST REGISTER B 

DEC B 

JR Z,OVRFLW ;BRANCH IF B CONTAINS ZERO 
Dec B 


Note that register B will contain 0 (not FFj¢) if the program branches to address 
OVRFLW. 


7. The sequence 


DEC BC 
JR NZ, LOOP 


has unpredictable results, since DEC does not affect any flags when it is applied to a 
16-bit operand. The correct sequence for decrementing and testing a 16-bit counter in 
register pair BC is 


DEC BC 
LD A,C 7;CHECK IF BC HAS ANY 1 BITS 
OR B 


JR NZ, LOOP ;BC CANNOT BE ZERO IF ANY BITS ARE 1 
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This sequence affects the accumulator and all the flags, including Carry (which OR 
clears). 


8. AND A or OR A clears Carry without affecting any registers. To clear Carry 
without affecting the other flags, use the sequence 
SCF sFIRST SET THE CARRY FLAG 
CCF * THEN CLEAR IT BY COMPLEMENTING 


9. SUBA or XOR A clears the accumulator, the Carry flag, and the Sign flag (and 
sets the Zero flag). To clear the accumulator without affecting the flags, use LD A,0. 


10. The sequence 


ADD HL,DE 
JR Z, BNDRY 


has unpredictable results, since ADD HL does not affect the Zero flag. To force a 
branch if the sum is 0, you must test HL explicitly as follows: 


ADD HL,DE 
LO A,H 7;TEST H AND L FOR ZERQ 
CR L 


JR Z, BNDRY 
An alternative is 
AND A *CLEAR CARRY 
ADC HL,DE 
JR Z, BNDORY 


Unlike ADD HL, ADC HL affects the Zero flag. 


CONFUSING REGISTERS AND REGISTER PAIRS 


The rules to remember are 


* ADC, ADD, DEC, INC, LD, and SBC can be applied to either 8-bit operands or 
16-bit register pairs. ADD, DEC, INC, and LD can also be applied to index registers. 


- AND, OR, SUB, and XOR can only be applied to 8-bit operands. 
- EX, POP, and PUSH can only be applied to register pairs or index registers. 


- (rp) refers to the byte of memory located at the address in the register pair. It does 
not refer to either half of the register pair itself. 


One commonerror is that of referring to H or Linstead of (HL). The use of register 
pairs to hold addresses means that certain transfers are uncommon. For example, LD 
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L,(HL) would load register L from the address in HL; HL would then contain one byte 
of an address (in H) and one byte of data (in L). While this is legal, it is seldom useful. 


Examples 


1. LD A,H 


This instruction moves register H to the accumulator. It does not change register H 
or any memory location. 


2. LD A,(BC) 


This instruction loads the accumulator from the memory address in register pair BC. 
It does not affect either register B or register C. 


3. LD H,0 


This instruction places 0 in register H. It does not affect memory. 


4. LD (HL),A 


This instruction stores the accumulator in the memory location addressed by 
register pair HL. It does not affect either H or L. A sequence that loads HL with an 
address indirectly is 


LOE, CHL) ;GET LSB OF INDIRECT ADDRESS 
INC HL 

LD oD, CHL) ;GET MSB OF INDIRECT ADDRESS 
EX DE,HL sPUT INDIRECT ADDRESS IN HL 


We may limit ourselves to a single temporary register (the accumulator) by loading the 
more significant byte directly into H as follows: 


LD A, CHL) sGET LSB OF INDIRECT ADDRESS 
INC HL 

LO H, CHL) >GET MSB OF INDIRECT ADDRESS 
LO L,A *MOVE LSB OF ADDRESS Ta L 


This takes the same number of clock cycles as the previous sequence, but uses A instead 
of DE for temporary storage. 


5. LD HL,2050H 
This instruction loads 2050 ¢ into register pair HL (20)¢ into H and 50j¢ into L). 


6. ADD A,(HL) 


This instruction adds the memory byte addressed via register pair HL to the 
accumulator. It does not affect either H or L. 
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7. ADD HL,HL 


This instruction adds register pair HL to itself, thus shifting HL left 1 bit logically. 
This instruction does not affect the accumulator or access data from memory. 


CONFUSING ADDRESSES AND DATA 


The rules to remember are 


- LD requires an address when you want to move data to or from memory. That 
address must be placed in parentheses. 


- The standard assembler treats all operands as data unless they are enclosed in 
parentheses. Thus, if you omit the parentheses around an address, the assembler will 
treat it as a data item. 


* DJNZ, JP, JR, and CALL always require addresses. 


There is some confusion with addressing terminology in jump instructions. These 
instructions essentially treat their operands as if one level of indirection had been 
removed. For example, we say that JP 2040H uses direct addressing, yet we do not 
place the address in parentheses. Furthermore, JP 2040H loads 2040j¢ into the 
program counter, much as LD HL,2040H loads 2040j¢ into register pair HL. LD 
HL,(2040H) loads the contents of memory locations 2040)¢ and 2041 )¢ into register 
pair HL. Note also that JP (HL) loads HL into the program counter; it does not use 
HL indirectly or access the memory at all. 


Examples 
1. LD A,40H loads the number 40)¢ into the accumulator. LD A,(40H) loads the 
contents of memory location 004016 into the accumulator. 


2. LD HL,OCOOH loads 0C00j¢ into register pair HL (OCj¢ into H and 00j¢ into L). 
LD HL,(OCOOH) loads the contents of memory locations 0C00);6 and 0CO1j.6 into 
register pair HL (the contents of 0C00)¢ into L and the contents of 0CO1j.¢ into H). 


3. JP (xy) transfers control to the address in an index register. No indexing is 
performed, nor is the address used to access memory. 


Confusing addresses and their contents is a common error in handling data struc- 
tures. For example, the queue of tasks to be executed by a piece of test equipment 
might consist of a block of information for each task. That block might contain 


- Starting address of the test routine 


- Number of seconds for which the test is to run 
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- Address in which the result is to be saved 
- Upper and lower thresholds against which the result is to be compared 


- Base address of the next block in the queue. 


Thus, the block contains data, direct addresses, and indirect addresses. Typical 
errors that a programmer could make are 


- Transferring control to the memory locations containing the starting address of 
the test routine, rather than to the actual starting address. 


- Storing the result in the block rather than in the address specified in the block. 


- Using a threshold as an address rather than as data. 


- Assuming that the next block starts in the current block, rather than at the base 
address given in the current block. 


Jump tables are another common source of errors. The following are alternative 
implementations: 


- Form a table of jump instructions and transfer control to the correct element (for 
example, to the third jump instruction). 


- Form a table of destination addresses and transfer control to the contents of the 
correct element (for example, to the address in the third element). 


You will surely have problems if the processor uses jump instructions as addresses or 
vice versa. 


FORMAT ERRORS 


The rules you should remember for the standard Z80 assembler are 


- An H at the end of a number indicates hexadecimal and a B indicates binary. 


- The default mode for numbers is decimal; that is, the assembler assumes all 
numbers to be decimal unless they are specifically marked otherwise. 


- All operands are treated as data unless they are enclosed in parentheses. Operands 
enclosed in parentheses are assumed to be memory addresses. 


- A hexadecimal number that starts with a letter digit (A, B, C, D, E, or F) must be 
preceded by 0 (for example, OCFH instead of CFH) for the assembler to interpret it 
correctly. Of course, the leading 0 does not affect the value of the number. 


- All arithmetic and logical operations are binary, except DAA, which corrects the 
result of an 8-bit binary addition or subtraction to the proper BCD value. 
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You should beware of the following common errors: 


- Omitting the H from a hexadecimal operand. The assembler will assume it to be 
decimal if it contains no letter digits and to be a name if it starts with a letter. The 
assembler will indicate an error only if it cannot interpret the operand as either a 
decimal number or a name. 


- Omitting the B from a binary operand. The assembler will assume it to be decimal. 


- Confusing decimal (BCD) representations with binary representations. Remem- 
ber, ten is not an integral power of two, so the binary and BCD representations are not 
the same beyond nine. BCD constants must be designated as hexadecimal numbers, 
not as decimal numbers. 


- Confusing binary or decimal representations with ASCII representations. An 
ASCII input device produces ASCII characters and an ASCII output device responds 
to ASCII characters. 


Examples 


1. LD A,(2000) 


This instruction loads the accumulator from memory address 2000 9 (07D0j¢), not 
address 200016. The assembler will not produce an error message, since 2000 is a valid 
decimal number. 


2. AND 00000011 


This instruction logically ANDs the accumulator with the decimal number 11 
(10114), not with the binary number 11 (319). The assembler will not produce an error 
message, since 00000011 is a valid decimal number despite its unusual form. 


3. ADD A,40 


This instruction adds the number 40)9 to the accumulator. Note that 400 is not the 
same as BCD 40, which 1s 4016; 4019 = 2816. The assembler will not produce an error 
message, since 40 is a valid decimal number. 


4. LD A,3 


This instruction loads the accumulator with the number 3. If this value is now sent to 
an ASCII output device, the device will respond as if it had received the character ETX 
(0346), not the character 3 (33,6). The correct version is 


LD A, “3° 7;GET AN ASCII 23 
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If memory location 2040)¢ contains a single digit, the sequence 
LD A, (2040H) 
QUT <(DEVCE),A 
will not print that digit on an ASCII output device. The correct sequence is 


LD A, (2040H) 7;GET DECIMAL DIGIT 
ADD A,“O” s;ADJUST TQ ASCII 
QUT <(DEVCE),A 


If input port INDEV contains a single ASCII decimal digit, the sequence 


IN A, CINDEV) 
LO (2040H),4A 


will not store the actual digit in memory location 2040.6. Instead, it will store the 
ASCII version, which is the actual digit plus 30;6. The correct sequence is 


IN A, CINDEV) GET ASCII DIGIT 
SUB “O° 7,ADJUST TQ DECIMAL 


LO (2040H),A 


Performing decimal arithmetic on the Z80 is awkward, since a DAA instruction 1s 
required after each 8-bit addition or subtraction. Chapter 6 contains programs for 
decimal arithmetic operations. Since DAA does not work properly after DEC or INC, 
the following sequences are necessary to perform decimal increment and decrement 
by |: 


- Add 1 to the accumulator in decimal. 


ADD A, 1 
DAA 


- Subtract | from the accumulator in decimal. 


SUB 1 
LIAA 
Or 
ADD A,99H 
DAA 


in the second alternative, Carry is an inverted borrow. 


HANDLING ARRAYS INCORRECTLY 


The most common problems here are executing an extra iteration or stopping one 
short. Remember, memory locations BASE through BASE+N contain N+! bytes, not 
N bytes. It is easy to forget the last entry or drop the first one. On the other hand, if you 
have N entries, they will occupy memory locations BASE through BASE+-N— 1; now it 
is easy to find yourself working beyond the end of the array. 
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IMPLICIT EFFECTS 


Some implicit effects you should remember are 


- The clearing of Carry by all logical operations except CPL. 


- The moving of the interrupt flip-flop IFF2 to the Parity / Overflow flag by LD A, I 
and LD A,R. 


- The use of the data at the address in HL by the digit rotations RRD and RLD. 


- The use of the memory address one larger than the specified one by LD 
rp,(ADDR), LD (ADDR),rp, LD xy,(ADDR), and LD (ADDR), xy. 


- The changing of the stack pointer by POP, PUSH, CALL, RET, RETI, RETN, 
and RST. 


- The saving of the return address in the stack by CALL and RST. 
- The decrementing of register B by DJNZ. 


- The implicit effects on BC, DE, and HL of the block compare, input, move, and 
output instructions. 


- The use of the Parity/ Overflow flag by LDD, LDI, CPD, CPDR, CPI, and CPIR 
to indicate whether the counter in BC has been decremented to 0. 


Examples 


1. AND 00001111B 


This instruction clears the Carry, as well as performing a logical operation. 


2. LD A,I 


This instruction not only loads the accumulator, but also moves the interrupt 
flip-flop IFF2 to the Parity/ Overflow flag. The interrupt status can then be saved 
before the computer executes a routine that must run with interrupts disabled. 


3. RRD 


This instruction performs a 4-bit (digit) circular shift right involving the accumula- 
tor and the memory location addressed by HL. The results are 


- The 4 least significant bits of A go into the 4 most significant bits of the memory 
location. 


- The 4 most significant bits of the memory location go into its 4 least significant 
bits. 
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- The 4 least significant bits of the memory location go into the 4 least significant 
bits of A. 


The result is thus a 4-bit right rotation of the 12-bit number made up of the 4 LSBs of 
the accumulator and the memory byte. 


4. LD HL,(16EFH) 


This instruction loads register L from memory location 16EFj¢ and H from memory 
location 16F0j¢. Note the implicit use of address 16FOj¢. 


5. POP HL 


This instruction not only loads register pair HL from memory, but also increments 
the stack pointer by 2. 


6. CALL SUBR 


This instruction not only transfers control to address SUBR, but it also saves the 
address of the next sequential instruction in the stack. Furthermore, CALL decre- 
ments the stack pointer by 2. 


7. DINZ LOOP 


This instruction decrements register B and branches to address LOOP if the result is 
not 0. Note that register B is implied as the counter. 


8. LDD 


This instruction moves data from the address in HL to the address in DE. It also 
decrements BC, DE, and HL by 1. The Parity/ Overflow flag (not the Zero flag) is 
cleared (not set) if BC is decremented to 0; the Parity/ Overflow flag is set otherwise. 


9. CPIR 


This instruction compares the accumulator with the memory byte at the address in 
HL. After the comparison, it increments HL by | and decrements BC by |. It repeats 
these operations until it decrements BC to 0 (indicated by the Parity/ Overflow flag 
being cleared) or until the comparison sets the Zero flag. Note that CPIR updates BC 
and HL before it tests for an exit condition. 


10. OUTI 


This instruction transfers data from the memory address in HL to the output port in 
C. It then decrements B (not BC) by | and increments HL by 1. OUTI sets the Zero flag 
to | if it decrements BC to 0; it clears the Zero flag otherwise. 
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INITIALIZATION ERRORS 


Initialization routines must perform the following tasks, either for the microcom- 
puter system as a whole or for particular routines: 


- Load all RAM locations with initial values. This includes indirect addresses and 
other temporary storage. You cannot assume that a memory location contains 0 just 
because you have not used it. 


- Load all registers and flags with initial values. Reset initializes the interrupt system 
by disabling regular interrupts and selecting Mode 0. The startup program for an 
interrupt-driven system must set the interrupt mode (if it is not 0), initialize the stack 
pointer, and load the interrupt vector register (in Mode 2). 


- Initialize all counters and indirect addresses. Pay particular attention to register 
pairs that are used as address registers; you must initialize them before using instruc- 
tions that refer to them indirectly. 


ORGANIZING THE PROGRAM 
INCORRECTLY 


The following problems are the most common: 


- Accidentally reinitializing a register, register pair, flag, memory location, counter, 
or indirect address. Be sure that your branches do not result in the repetition of 
initialization instructions. 


- Failing to update a counter, index register, address register, or indirect address. A 
problem here may be a path that branches around the updating instructions or changes 
values before executing those instructions. 


- Forgetting to save results. It is remarkably easy to calculate a result and then load 
something else into the accumulator. Identifying this kind of error is frustrating and 
time-consuming, since all the instructions that calculate the result work properly and 
yet the result itself is being lost. For example, a branch may transfer control to an 
instruction that writes over the result. 


- Forgetting to branch around instructions that should not be executed in a particu- 
lar path. Remember, the computer will execute instructions consecutively unless told 
to do otherwise. Thus, the computer may fall through to a section of the program that 
you expect it to reach only via a branch. An unconditional jump instruction will force a 
branch around the section that should not be executed. 
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ERROR RECOGNITION BY ASSEMBLERS 


Most assemblers will recognize some common errors immediately, such as 


- Undefined operation code (usually a misspelling or the omission of acolonaftera 
label). 


- Undefined name (often a misspelling or an omitted definition). 

- Illegal character (for example, a 2ina binary number or a Bina decimal number). 
- Illegal format (for example, an incorrect delimiter or the wrong operands). 

- Illegal value (usually a number too large for 8 or 16 bits). 

- Missing operand. 

- Double definition (two different values assigned to one name). 


- Illegal label (for example, a label attached to a pseudo-operation that does not 
allow a label). 


- Missing label (for example, on an EQU pseudo-operation that requires one). 


These errors are annoying but easy to correct. The only problem comes when an 
error (such as omitting the semicolon from a comment line) confuses the assembler 
completely and results in a series of meaningless error messages. 

There are, however, many simple errors that assemblers will not recognize. The 
programmer should be aware that his or her program may contain such errors even if 
the assembler does not report them. Typical examples are 


- Omitted lines. Obviously, the assembler cannot tell that you have omitted a line 
completely unless it contains a label or definition that is used elsewhere. The easiest 
lines to omit are ones that are repetitious or seem unnecessary. Typical repetitions are 
series of shifts, branches, increments, or decrements. Instructions that often appear 
unnecessary include AND A, DEC HL, INC HL, OR A, and SUB A. 


- Omitted designations. The assembler cannot tell if you meant an operand to be 
hexadecimal or binary unless the omission results in an illegal character (suchas Cina 
decimal number). Otherwise, the assembler will assume all numbers to be decimal. 
Problems occur with hexadecimal numbers that contain no letter digits (such as 44 or 
2050) and with binary numbers (such as 00000110). 


- Omitted parentheses. The assembler cannot tell if you meant to refer to a memory 
address unless omitting the parentheses results in an error. Many instructions, such as 
LD A,(40H), INC (HL), DEC (HL), and LD HL,(2050H), are also valid without 
parentheses. 


- Misspellings that are still valid. Typical examples are typing AND or ADC instead 
of ADD, DI instead of EI, or D instead of E. Unless the misspelling is invalid, the 
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assembler has no way of sensing an error. Valid misspellings are often a problem if you 
use names that look alike, such as XXX and XXXX, L121 and L112, or VARII and 
VARII. 


- Designating instructions as comments. If you place a semicolon at the start of an 
instruction line, the assembler will treat the line as a comment. This can bea perplexing 
error, since the line appears in the listing but is not assembled into code. 


Sometimes you can confuse an assembler by entering completely invalid instruc- 
tions. An assembler may accept them simply because its developer never anticipated 
such mistakes. The results can be unpredictable, much like the result of accidentally 
entering your weight instead of your age or your telephone number instead of your 
credit card number on a form. Some cases in which a Z80 assembler can go wrong are 


- If you specify a single register instead of a register pair. Some assemblers will 
accept instructions like LD A,(L), ADD HL,D, or LD E,2040H. They will produce 
meaningless object code without any indication of error. 


- If you enter an invalid digit, such as X ina decimal or hexadecimal number or 7 in 
a binary number. Some assemblers will assign arbitrary values to such invalid digits. 


- If you enter an invalid operand such as 40H in RST, AFin LD, or SPin PUSH or 
POP. Some assemblers will accept these and generate meaningless code. 


The assembler will only recognize errors that its developer anticipated. Pro- 
grammers are often able to make mistakes the developer never imagined, much as 
automobile drivers are often capable of getting into predicaments that no highway 
engineer or traffic policeman ever thought possible. Note that only a line-by-line hand 
checking of the program will find errors that the assembler does not recognize. 


COMMON ERRORS IN I/O DRIVERS 


Since most errors in I/O drivers involve both hardware and software, they are 
difficult to categorize. Some things you should watch for are 


- Confusing input ports and output ports. Input port 20)¢ and output port 2016 are 
different in most systems. Even when the two ports are the same physically, it may still 
be impossible to read back output data unless the port is latched and buffered. 


- Attempting to perform operations that are physically impossible. Reading data 
from an output device (such as a display) or sending data to an input device (suchas a 
keyboard) makes no physical sense. However, accidentally using the wrong port 
number will cause no assembly errors; the port, after all, exists and the assembler has 
no way of knowing that certain operations cannot be performed on it. Similarly, a 
program may attempt to save data in an unassigned address or in a ROM. 
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- Forgetting implicit hardware effects. At times, transferring data to or from a port 
will change the status lines automatically (as in most PIO modes). Even reading or 
writing the port while debugging a program will change status lines. When using 
memory-mapped I/O, be particularly careful of instructions like comparisons and BIT 
that read a memory address even though they do not change any registers. Similarly, 
instructions like BIT, RES, SET, DEC, INC, and shifts can both read and write a 
memory address. Automatic port operations can save parts and simplify programs, but 
you must remember how they work and when they occur. 


- Reading or writing without checking status. Many devices can only accept or 
provide data when a status line indicates they are ready. Transferring data to or from 
them at other times will have unpredictable results. 


- Ignoring the differences between input and output. Remember that an input device 
normally starts out not ready — it has no data available although the computer is ready 
to accept data. On the other hand, an output device normally starts out ready — that is, 
it could accept data but the computer usually has none to send it. In many situations 
(particularly when using PIOs), you may have to send a null character (something that 
has no effect) to each output port just to change its state from ready to not ready 
initially. 

- Failing to keep a copy of output data. Generally, you will not be able to read data 
back from an output port. You must save a copy in memory if it could be needed later to 
repeat a transmission, change some bits, or restore interrupt status (the data could, for 
example, be the current priority level). 


- Reading data before it is stable or while it is changing. Be sure that you understand 
exactly when the data from the input device is guaranteed to be stable. In the case of 
switches that may bounce, you may want to sample them twice (more than a debounc- 
ing time apart) before taking any action. In the case of keys that may bounce, you may 
want to take action only when they are released rather than when they are pressed. 
Acting on release also forces the operator to release the key rather than holding it 
down. In the case of persistent data (such as in serial I/O), you should center the 
reception (that is, read the data near the centers of the pulses rather than at the edges 
where the values may be changing). 


- Forgetting to reverse the polarity of data being transferred to or from devices that 
operate in negative logic. Many simple I/O devices, such as switches and displays, use 
negative logic; a logic 0 means that a switch is closed or a display is lit. Common 
ten-position switches or dials also often produce data in negative logic, as do many 
encoders. The solution is simple —complement the data using CPL after reading it or 
before sending it. 


- Confusing actual I/O ports with registers that are inside I/O chips. Programmable 
I/O devices, such as the CTC, PIO, and SIO, typically have control or command 
registers that determine how the device operates and status registers that reflect the 
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current state of the device or the transfer. These registers are inside the chips; they are 
not connected to peripherals. Transferring data to or from these registers is not the 
same as transferring data to or from actual I/O ports. 


- Using bidirectional ports improperly. Many devices, such as the PIO, have bidirec- 
tional I/O ports that can be used either for input or output. Normally, resetting the 
computer makes these ports inputs in order to avoid initial transients, so the program 
must explicitly change them to outputs if necessary. Be particularly careful of instruc- 
tions that read bits or ports that are designated as outputs or that write into bits or 
ports designated as inputs. The only way to determine what will happen is to read the 
documentation for the specific device. 


- Forgetting to clear status after performing an I/O operation. Once the processor 
has read data from a port or written data into a port, that port should revert to the not 
ready state. Some I/O devices change the status of their ports automatically after input 
or output operations, but others either do not or they change status automatically only 
after input. Leaving the status set can result in an endless loop or erratic operation. 


COMMON ERRORS IN INTERRUPT 
SERVICE ROUTINES 


Many errors that are related to interrupts involve both hardware and software. The 
following are some of the more common mistakes: 


- Failing to reenable interrupts. The Z80 disables interrupts automatically after 
accepting one, but does not reenable interrupts unless it executes EI. 


- Failing to save registers. The Z80 does not automatically save any registers except 
the program counter, so any registers that the service routine uses must be saved 
explicitly in the stack. 


- Saving or restoring registers in the wrong order. Registers must be restored in the 
opposite order from that in which they were saved. 


- Enabling interrupts before initializing modes, priorities, the interrupt vector 
register, or other parameters of the interrupt system. 


- Forgetting that the response to an interrupt includes saving the program counter 
at the top of the stack. The return address will thus be on top of whatever else is in the 
stack. 


- Not disabling the interrupt during multi-byte transfers or instruction sequences 
that cannot be interrupted. In particular, watch for possible partial updating of data 
(such as time) that a service routine may use. 


CHAPTER 3: COMMON PROGRAMMING ERRORS 459 


- Failing to reenable interrupts after a sequence that must be run with interrupts 
disabled. One problem here is that interrupts should not be enabled afterward if they 
were not enabled originally. This requirement is difficult to meet on the Z80 since its 
interrupt enable is not directly readable. The only way to access the interrupt flip-flop 
is by executing LD A,I or LD A,R; either instruction moves the interrupt flip-flop to 
the Parity/ Overflow flag. 


- Failing to clear the signal that caused the interrupt. The service routine must clear 
the interrupt even if no I/O operations are necessary. For example, even when the 
processor has no data to send to an interrupting output device, it must nonetheless 
either clear or disable the interrupt. Otherwise, the processor will get caught in an 
endless loop. Similarly, a real-time clock will typically require no servicing other than 
an updating of time, but the service routine still must clear the clock interrupt. This 
clearing may involve reading a timer register. 


- Failing to communicate with the main program. The main program will not know 
that the interrupt has been serviced unless it is informed explicitly. The usual way to 
inform the main program is to have the service routine change a flag. The main 
program can tell from the flag’s value whether the service routine has been executed. 
This procedure works like a postal patron raising a flag to indicate that there is mail to 
be picked up. The letter carrier lowers the flag after picking up the mail. Note that this 
simple procedure means that the main program must examine the flag often enough to 
avoid missing changes in its value. Of course, the programmer can always provide a 
buffer that can hold many data items. 


- Failing to save and restore priority. The priority of an interrupt is often held ina 
write-only register or in a memory location. That priority must be saved just like a 
CPU register and restored properly at the end of the service routine. If the priority 
register is write-only, a copy of its contents must be saved in memory. 
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Introduction to the 
Program Section 


The program section contains sets of assembly language subroutines for the Z80 
microprocessor. Each subroutine is documented with an introductory section and 
comments and is followed by at least one example of its use. The introductory material 
contains the following information about the purpose of the routine: its procedure and 
the registers that are used; the execution time, program size, and data memory 
required for the routine; as well as special cases, entry conditions, and exit conditions. 

We have made each routine as general as possible. This is particularly difficult for 
the input/output (I/O) and interrupt service routines described in Chapters 10 and 11, 
since these routines are always computer-dependent in practice. In such cases, we have 
limited the computer-dependence to generalized input and output handlers and inter- 
rupt managers. We have drawn specific examples from computers based on the CP/M 
operating system, but the general principles are applicable to other Z80-based com- 
puters as well. 

In all routines, we have used the following parameter passing techniques: 


1. Asingle 8-bit parameter is passed in the accumulator. A second 8-bit parameter is 
passed in register B, and a third in register C. 


2. A single 16-bit parameter is passed in register pair HL with the more significant 
byte in H. A second 16-bit parameter is passed in register pair DE with the more 
significant byte in D. 


3. Large numbers of parameters are passed in the stack, either directly or indirectly. 
We assume that subroutines are entered via a CALL instruction that places the return 
address at the top of the stack, and hence on top of the parameters. 


Where there has been a choice between execution time and memory usage, we have 
generally chosen to minimize execution time. We have therefore avoided slowly 
executing instructions such as stack transfers and instructions that use the index 
registers, even when they would make programs shorter. However, we have used 
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relative jumps whenever possible rather than the slightly faster but longer absolute 
jumps to make programs easier to relocate. 

We have also chosen the approach that minimizes the number of repetitive calcula- 
tions. For example, in the case of array indexing, the number of bytes between the 
starting addresses of elements differing only by one in a particular subscript (known as 
the size of that subscript) depends only on the number of bytes per element and the 
bounds of the array. Thus, the sizes of the various subscripts can be calculated as soon 
as the bounds of the array are known; the sizes are therefore used as parameters for the 
indexing routines, so that they need not be calculated each time a particular array is 
indexed. 

As for execution time, we have specified it for most short routines. For longer 
routines we have given an approximate execution time. The execution time of pro- 
grams involving many branches will obviously depend on which path the computer 
follows in a particular case. This is further complicated for the Z80 because condi- 
tional jump instructions themselves require different numbers of clock cycles depend- 
ing on whether the branch is taken. Thus, a precise execution time is often impossible 
to define. The documentation always contains at least one typical example showing an 
approximate or maximum execution time. 

Although we have drawn examples from CP/ M-based systems, we have not made 
our routines compatible with the 8080 or 8085 processors. Readers who need routines 
that can run on any of these processors should refer to the 8080/8085 version of this 
book. We have considered the Z80 as an independent processor and have taken 
advantage of such features as block moves, block compares, loop control instructions, 
and relative jumps. 

Our philosophy on error indicators and special cases has been the following: 


1. Routines should provide an easily tested indicator (such as the Carry flag) of 
whether any errors or exceptions have occurred. 


2. Trivial cases, such as no elements in an array or strings of zero length, should 
result in immediate exits with minimal effect on the underlying data. 


3. Incorrectly specified data (such as a maximum string length of zero or an index 
beyond the end of an array) should result in immediate exits with minimal effect on the 
underlying data. 


4. The documentation should include a summary of errors and exceptions (under 
the heading of “Special Cases”). 


5. Exceptions that may actually be convenient for the user (such as deleting more 
characters than could possibly be left in a string rather than counting the precise 
number) should be handled in a reasonable way, but should still be indicated as errors. 


Obviously, no method of handling errors or exceptions can ever be completely 
consistent or well-suited to all applications. And rather than assume that the user will 
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always provide data in the proper form, we believe a reasonable set of subroutines 
must deal with this issue. 
The subroutines are listed as follows: 


Code Conversion 


4A Binary to BCD Conversion 167 

4B BCD to Binary Conversion 170 

4C Binary to Hexadecimal ASCII Conversion 172 

4D Hexadecimal ASCII to Binary Conversion 175 

4E Conversion of a Binary Number to Decimal ASCII 178 
4F Conversion of ASCII Decimal to Binary 183 

4G Lower-Case to Upper-Case Translation 187 

4H ASCII to EBCDIC Conversion 189 

4! EBCDIC to ASCII Conversion 192 


Array Manipulation and Indexing 


SA Memory Fill 195 

5B Block Move 198 

5C Two-Dimensional Byte Array Indexing 201 
5D Two-Dimensional Word Array Indexing 205 
SE N-Dimensional Array Indexing 209 


Arithmetic 


6A 16-Bit Multiplication 217 

6B 16-Bit Division 220 

6C 16-Bit Comparison 225 

6D Multiple-Precision Binary Addition 228 

6E- Multiple-Precision Binary Subtraction 231 
6F Multiple-Precision Binary Multiplication 234 
6G Multiple-Precision Binary Division 239 
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él 
6J 
6K 
6L 
6M 
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Multiple-Precision Binary Comparison 245 
Multiple-Precision Decimal Addition 248 
Multiple-Precision Decimal Subtraction 251 
Multiple-Precision Decimal Multiplication 254 
Multiple-Precision Decimal Division 260 


Multiple-Precision Decimal Comparison 266 


Bit Manipulations and Shifts 


7A Bit Field Extraction 267 

7B Bit Field Insertion 270 

1 Multiple-Precision Arithmetic Shift Right 273 
7D Multiple-Precision Logical Shift Left 276 
TE Multiple-Precision Logical Shift Right 279 
fi Multiple-Precision Rotate Right 282 

7G Multiple-Precision Rotate Left 285 
String Manipulation 

8A String Compare 288 

8B String Concatenation 292 

8C Find the Position of a Substring 297 

8D Copy a Substring from a String 302 

8E Delete a Substring from a String 308 

8F Insert a Substring into a String 313 
Array Operations 

9A 8-Bit Array Summation 319 

9B 16-Bit Array Summation 322 

9C Find Maximum Byte-Length Element 325 
9D Find Minimum Byte-Length Element 328 
9E Binary Search 331 
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9F Quicksort 336 
9G RAM Test 347 
9H Jump Table 352 


Input/Output 


10A Read a Line froma Terminal 356 

10B Write a Line to an Output Device 365 
10C CRC-16 Checking and Generation 368 
10D I/O Device Table Handler 373 

10E Initialize 1/O Ports 385 

10F Delay Milliseconds 391 


Interrupts 


11A Unbuffered Input/Output Using an SIO 394 
11B Unbuffered Input/Output Usinga PIO 404 
11C Buffered Input/Output Using an SIO 413 
11D Real-Time Clock and Calendar 425 


Binary to BCD Conversion (BN?BCLD) 


Converts one byte of binary data to two bytes 
of BCD data. 

Procedure: The program subtracts 100 repeat- 
edly from the original data to determine the 
hundreds digit, then subtracts 10 repeatedly 
from the remainder to determine the tens digit, 
and finally shifts the tens digit left four positions 
and combines it with the ones digit. 


Entry Conditions 


Binary data in A 


Examples 


1. Data: 
Result: 


(A) = 6Ej¢ (110 decimal) 


(H) = 01,6 (hundreds digit) 
(L) = 10,6 (tens and ones digits) 


“use «“s “ws “es “8 “8S “8S “SS 


Title 

Name: BN2ZBCD 
; Furposes Canvert 
; bytes of BCD 
H Entrys Register A = 
; Exits Register H = 
; Register L = 


Registers used: AF,C,HL 


Binary toa BCD ceanversion 


ane byte of binary data to two 


AA 


Registers Used: AF, C, HL 


Execution Time: 497 cycles maximum; depends on 
the number of subtractions required to determine the 


tens and hundreds digits 
Program Size: 27 bytes 
Data Memory Required: None 





Exit Conditions 


Hundreds digit in H 
Tens and ones digits in L 


2. Data: 


Result: 


(A) = B7j¢ (183 decimal) 


(H) = 01,, (hundreds digit) 
(L) = 83) (tens and ones digits) 


“wa “ews “SB MP MR UE OS 


data 
binary data 


High byte af BCD data 
Low byte of BCD data 


ws “38 “8 “8 Ss UMS lulu US Oe 
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“e6ss “SNS MSE ONS 


DLIOOLFs: 


DLOLP: 


~w«“s 4“ “Ss 6“ 


SC4A: 


Times 497 cycles maximum 

Sizes: Frogram 27 bytes 

sCALCULATE 100°S DIGIT - DIVIDE BY 100 

s H = QUOTIENT 

: A = REMAINDER 

LO H, OF FH sSTART QUOTIENT AT —1 
INC H sADO 1 TQ QUCTIENT 

SUB 100 s;SUBTRACT 100 

JR NC, DLOOLP :JUMP IF DIFFERENCE STILL POSITIVE 
ADD A, 100 ‘ADD THE LAST 100 BACK 
sCALCULATE 10°S AND 1°S DIGITS 

: DIVIDE REMAINDER OF THE 100°S DIGIT BY 16 

= L = 10°S DIGIT 

* A = 1°S DIGIT 

LO L,OFFH sSTART QUOTIENT AT -1i 
INC L Oo 1 TO QUOTIENT 


7A 
SUB 10 :SUBTRACT 10 
JR NC, D1OLP 7JUMP IF DIFFERENCE STILL POSITIVE 
ADD A,10 ;ADD THE LAST 10 BACK 


sCOMBINE 1°S AND 10°S5 DIGITS 
Lo C,A ;SAVE 1°S DIGIT INC 

LO A,L 

RLCA sMOVE 10°5 TO HIGH NIBBLE OF A 
RLOA 

RLCA 

RLCOA 

QR C s;QR IN THE 1°S DIGIT 


7;RETURN WITH L = LOW BYTE, H = HIGH BYTE 


LD L,A 
RET 


SAMPLE EXECUTION: 


;CONVERT OA HEXADECIMAL TO 10 BCD 
LO A, OAH 
CALL BN2ZBCD 7H = 0, L = 10H 


CONVERT FF HEXADECIMAL TO 255 BCD 


—us «ws “Ss UP UMS ONS 


ss 8 “se us WS 
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LO A, OF FH 

CALL BN2BCD 7H = O2H, L = S53H 
;CONVERT O HEXADECIMAL TQ 0 BCD 

LD A,O 

CALL BN2ZBCD aH = 0, L = 0 

AR SC4A 


END 


BCD to Binary Conversion (BCD2B8N) 


Converts one byte of BCD data to one byte 
of binary data. 

Procedure: The program masks off the more 
significant digit, multiplies it by 10 using shifts 
(10=8-+ 2, and multiplying by 8 or by 2 is equiv- 
alent to three or one left shifts, respectively). 
Then the program adds the product to the less 
significant digit. 


Entry Conditions 


BCD data in A 


Examples 


1. Data: (A) = 99:6 
Result: (A) = 6316 = 9949 


ww ss 6 “s “8 ws WS UR OSS 


Entry: Register A = 


Exits Register A 
Registers used: A,B,C,F 


Times 60 cycles 


~—ae6s98 “8 ws NS 6S UE US UME UNS UNS 
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Title BCO toa binary 
Names BCD2ZBN 
Furpases 


Registers Used: AF, BC 
Execution Time: 60 cycles 


Program Size: 14 bytes 
Data Memory Required: None 


Exit Conditions 


Binary data in A 


2. Data: (A) = 2316 
Result: (A) = 1716 = 2349 


canversioan 


Convert one byte of BCD data to one 
byte af binary data 


BCD data 


Binary data 


AB 





“ws “ss “Ss “S “MB NR MSH ONE 


“us 


“~wse 6“S “SSB 6S 6S 


ue «ua 6S NS 4S 6S 
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Fragram 14 bytes 


ws “ses ws «8 
iy 
-- 
Ped 
% 
as 
“se “se we we 


ECO2EN: 
sMULTIPLY UPPER NIBBLE BY 10 AND SAVE IT 
; UPPER NIBBLE * 10 = UPPER NIBBLE * (8 + 2) 
Lo BLA sSAVE ORIGINAL BCO VALUE IN BE 
AND OF OH sMASK OFF UPPER NIBELE 
RRCA ;SHIFT RIGHT 1 BIT 
LO C,A sC = UPPER NIBBLE # 8 
RRCA :SHIFT RIGHT 2 MORE TIMES 
RRCA :A = UPPER NIBBELE = 2 
Ang A,C 
Lo c,A :C = UPPER NIBBLE ® (@+2) 
sGET LOWER NIBBLE AND ADD IT TO THE 
> BINARY EQUIVALENT OF THE UFPER NIBBLE 
Lo A,B :GET ORIGINAL VALUE BACK 
AND OFH >sMASK OFF UPPER NIBBLE 
Ann A,C »A0D TO BINARY UPPER NIBEBLE 
RET 
; SAMPLE EXECUTION: : 
SC4E: 
>CONVERT O ECD TO O HEXADECIMAL 
LD A,O 
CALL BCOZEN 7A = OH 
sCONVERT 97 BCD TQ 43 HEXADECIMAL 
Lo A, O99H 
CALL BCDO2EN »A=42H 
sCONVERT 23 BCD TO 17 HEXADECIMAL 
Lo A, 23H 
CALL BCO2BN +A=17H 
JR SC4EB 


END 


Binary to Hexadecimal ASCII 


Conversion (BN2HEX) 


Converts one byte of binary data to two 
ASCII characters corresponding to the two 
hexadecimal digits. 

Procedure: The program masks off each hexa- 
decimal digit separately and converts it to its 
ASCII equivalent. This involves a simple addi- 
tion of 3016 if the digit 1s decimal. If the digit is 
non-decimal, an additional 7 must be added to 


Eniry Conditions 


Binary data in A 


Examples 
I. Data: (A) = FBy6 
Result: (H) = 46,6 (ASCII F) 


(L) = 42,, (ASCII B) 


te) eS eS ee ee 


Title Binary tea hex ASCII 
Names: BN2HE X 
; Furpases Canvert 
; two ASCII characters 
; Entry: Register A = 
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ane byte of binary data tea 


Binary data 


se 


Registers Used: AF, B, HL 


Execution Time: 162 cycles plus two extra cycles for 
each non-decimal digit 


Program Size: 28 bytes 
Data Memory Required: None 





account for the break between ASCII 9 (39 j6) 
and ASCII A (41 16): 


Exit Conditions 


ASCII version of more significant hexadecimal 
digit in H 

ASCII version of less significant hexadecimal 
digit in L 


2. Data: 
Result: 


(A) = 5916 


(H) = 35). (ASCII 5) 
(L) = 3916 (ASCII 9) 


sus “ss «we “8S “8 UH UNS ONS 


“Ss “Ss 


“us <“s “SG “ae 


“st “8S “St “So NS 6NEB USER USE USS NE 


NASCIT: 


“s “s “8 “SS “4S 


wn 


N2 


© 
> 
m 


HE X 
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Exits Register H 


ASCII more significant digit 


Register L = ASCII less significant digit 


Registers used: AF,B,HL 
Times: Appraximately 162 cycles 


Size: Fragram 28 bytes 


s;CONVERT HIGH NIBBLE 


LO B,A SAVE ORIGINAL BINARY VALUE 
AND OF OH :;GET HIGH NIBELE 

RRCA *MQOVE HIGH NIBBLE TO LOW NIBELE 
RRCA 

RRCOA 

RACA 

CALL NASCII CONVERT HIGH NIBEBLE Ta ASCII 
LO H,A sRETURN HIGH NIGBLE IN H 
sCONVERT LOW NIBBLE 

LO A,B 

AND OFH ;GET LOW NIBBLE 

CALL NASCII CONVERT LOW NIBBLE Ta ASCII 
Ln L,A s;RETURN LOW NIBBLE IN L 

RET 


; SUBROUTINE ASCII 

7 PURPOSE: CONVERT A HEXADECIMAL DIGIT TQ ASCII 
s;ENTRY: A = BINARY DATA IN LOWER NIBELE 

sEXIT: A = ASCII CHARACTER 

SREGISTERS USED: A,F 


CF 10 

JR C,NAS1 JUMP IF HIGH NIBBLE < 10 

ADD A,7 sELSE ADD 7 SOQ AFTER ADDING “0” 
: CHARACTER WILL BE IN “Av%..°F° 

AnD A,*O° sADD ASCII O TQ MAKE A CHARACTER 

RET 


SAMPLE EXECUTION: 


s;CONVERT O TQ “00° 
LD A,O 


THE 


“ua 6ss 6G UNS UNH UNS ONS 


aa 6©“e8@ 6S 


use “es «ws “SB ONS 
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CALL BN2HE X 7;H=“O°=30H, L=°0"=30H 


sCONVERT FF HEX TO “FF 
LD A, OFFH 


CALL BN2HE X 7;H=°F°=46H, L=“F°=46H 
;CONVERT 23 HEX TQ “23° 

LD A, 23H 

CALL BN2HE X FH=°2°=32H, L=°3°=3:3H 


JR S$c4c 


END 


Hexadecimal ASCII to Binary 


Conversion (HEX28N) 


Converts two ASCII characters (represent- 
ing two hexadecimal digits) to one byte of 
binary data. 

Procedure: The program converts each ASCII 
character separately to a hexadecimal digit. This 
involves a simple subtraction of 30;¢6 (ASCII 0) 
if the digit is decimal. If the digit is non-decimal, 
another 7 must be subtracted to account for the 
break between ASCII 9 (396) and ASCII A 
(41 ,¢). The program then shifts the more signif- 
icant digit left four bits and combines it with the 


Entry Conditions 


More significant ASCII digit in H, less signifi- 
cant ASCII digit in L 


Examples 
1. Data: (H) = 44,6 (ASCII D) 
(L) = 37\6 (ASCII 7) 
Result: (A) = D7i6 
; Title He x 
; Name: HE X2BN 


Purpases Convert twa 


as “8 “8 “SH OB 


Entrys Register H = 


ASCII ta binary 


ASCII characters tea 
byte af binary data 


ASCII more significant digit 


AD 


Registers Used: AF, B 


Execution Time: 148 cycles plus two extra cycles for 
each non-decimal digit 


Program Size: 24 bytes 
Data Memory Required: None 





less significant digit. The program does not 
check the validity of the ASCII characters (that 
is, whether they are indeed the ASCII represen- 
tations of hexadecimal digits). 


Exit Conditions 


Binary data in A 


2. Data: (H) = 31,6 (ASCII 1) 
(L) = 42,6 (ASCII B) 
Result: (A) = 1Bi¢ 


wa ws ws “8S “NS OMS UNH OSS 


On2 


“uses “8s “38 “Se ws 
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ASCII less significant digit 


Register L 
Exits Register A = Binary data 


Registers used: AF,B 


at es | eS ee) i ee) i) ee? es TY 


Times Approximately 148 cycles 
Size: Fragram 24 bytes 
HE X2E:N:s 
LO A,L ‘GET LOW CHARACTER 
CALL AZHE X *CONVERT IT To HEXADECIMAL 
LO B,A SAVE HEX VALUE IN B 
LO A,H sGET HIGH CHARACTER 
CALL AZHE X sCONVERT IT To HEXADECIMAL 
RRCOA *SHIFT HEX VALUE TO UFPER 4 BITS 
RROA 
RROA 
RRA 
OR B -QR IN LOW HEX VALUE 
RET 
SUBROUTINE: AZHEX 
s;PURPOSE: CONVERT ASCII DIGIT TQ A HEX DIGIT 
sENTRY: A = ASCII HEXADECIMAL DIGIT 
sEXIT: A = BINARY VALUE OF ASCII DIGIT 
sREGISTERS USED: A,F 
ASHE X : 
SUB “Or ;SUBTRACT ASCII GFFSET 
a io 
JR C, AZHEX Ii BRANCH IF A IS A DECIMAL DIGIT 
SUB 7 sELSE SUBTRACT OFFSET FOR LETTERS 
AZHEX1:s 
RET 
; SAMPLE EXECUTION: 
SC4Ci: 
sCONVERT “C7" TO C7 HEXADECIMAL 
Lo H,°C°* 
LO Le f 
CALL HE X2EN 2 A=C07H 


;CONVERT “2F° TO 2F HEXADECIMAL 
Lo H, “2° 
LD batr* 


“us 0648 “NEB NE OMS 


“us “s “Ss “8 “Ss “BS 


“us ws “SB NS NB 
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CALL HE X2EN 7 A=2FH 

7;CONVERT “2A” TO 2A HEXADECIMAL 
LO H, “2" 

LD L, “A” 

CALL HE X2BN 3 A=2AH 

JR Ssc4o0 


END 


Conversion of a Binary Number to 


Decimal ASCII (8N2DEC) 


Converts a 16-bit signed binary number into 
an ASCII string. The string consists of the 
length of the number in bytes, an ASCII minus 
sign (if needed), and the ASCII digits. Note that 
the length is a binary number, not an ASCII 
number. 

Procedure: The program takes the absolute 
value of the number if it is negative. The program 
then keeps dividing the absolute value by 10 
until the quotient becomes 0. It converts each 
digit of the quotient to ASCII by adding ASCII 0 
and concatenates the digits along with an ASCII 


Entry Conditions 


Base address of output buffer in HL 
Value to convert in DE 


Examples 


1. Data: 
Result (in output buffer): 


Value to convert = 3EB7\¢ 


05 (number of bytes in buffer) 
31 (ASCII 1) 

36 (ASCII 6) 

30 (ASCII 0) 

35 (ASCII 5) 

35 (ASCII 5) 

That is, 3EB7)¢ = 16055, 
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Registers Used: AF, BC, DE, HL 
Execution Time: Approximately 7200 cycles 
Program Size: 107 bytes 


Data Memory Required: Four bytes anywhere in 
memory for the buffer pointer (two bytes starting at 


address BUFPTR), the length of the buffer (one byte 
at address CURLEN), and the sign of the original 
value (one byte at address NGFLAG). This data 
memory does not include the output buffer which 
should be seven bytes long. 





minus sign (in front) if the original number was 
negative. 


Exit Conditions 


Order in buffer: 


Length of the string in bytes (a binary number) 
ASCII — (if original number was negative) 
ASCII digits (most significant digit first) 


2. Data: 
Result (in output buffer): 


03 (number of bytes in buffer) 

2D (ASCII —) 

35 (ASCH 5) 

36 (ASCII 6) 

That is, FFC8)¢ = —56)9, when considered as a 
signed two’s complement number 


Value to convert = FFC8j¢ 
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“us “8 Ss “8 


7 ee, ee et ee ee et 


: Title Binary tea decimal ASCII 
; Name: BN2ZDEC 
FPurpases Convert a 1lé&—-bit signed binary number 


to ASCII data 


Entry: Register H = High byte of aqutput buffer address 
Register L = Low byte of aqutput buffer address 
Register D = High byte af value to ceanvert 
Register E = Low byte of value to convert 

Exits The first byte of the buffer is the length, 


followed by the characters. 


Registers used: AF, BC, DE, HL 


Times: Appraximately 7,200 cycles 
Sizes: Fragram 107 bytes 
Data 4 bytes 


“ws “Ss “4 “WES “WS “SS “WS “SB wh wR NSH MH SEB ONS UNS UNS NE UNE UNS Oe 
as “2 “8 wes “Ss we “Ss MB OSS NE OUR UNE UNE UNS UNS UNH UNH UNS UNS ONS 


BN2DEC : 
7SAVE PARAMETERS 
LO (BUFPTR),HL 7;STORE THE BUFFER POINTER 
EX DE, HL 
LD 4,9 
LD (CURLEN),A ;CURRENT BUFFER LENGTH If Oo 
LO A,H 
LD (NGFLAG),A ;SAVE SIGN OF VALLE 
QR A SET FLAGS FROM VALUE 
JP P, CNVERT ;JUMP IF VALUE IS POSITIVE 
EX DE, HL 7;ELSE TAKE ABSOLUTE VALUE ¢€O — VALUE) 
LD HL, O 
OR A 7;CLEAR CARRY 
SBC HL, DE ;SUBTRACT VALUE FROM 0 
sCONVERT VALUE TO A STRING 
CNVERT : 
-;HLE s:= HL DIV 10 CDOIVIDEND, QUOTIENT) 
7;DE s:= HL MOD 10 CREMAINDER) 
LO E,O 7;REMAINDER = 0 
LD B,16 716 BITS IN DIVIDEND 
OR A ;CLEAR CARRY TO START 
DVLOOP : 


HIFT THE NEXT BIT OF THE QUOQTIENT INTO BIT O OF THE DIVIDEND 
HIFT NEXT MOST SIGNIFICANT BIT OF DIVIDEND INTO 
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DECCNT : 


EXIT: 


LEAST SIGNIFICANT BIT OF REMAINDER 

HL HOLDS BOTH DIVIDEND AND QUOTIENT. QUOTIENT IS SHIFTED 
IN AS THE DIVIDEND IS SHIFTED OUT. 

7;E IS THE REMAINDER. 


us “sas “4S 


7;DQ A 24-BIT SHIFT LEFT, SHIFTING 
; CARRY TOL, L TO H, H TOE 


RL L sCARRY (NEXT BIT OF QUCTIENT) TQ BIT 0 
RL H ;SHIFT HIGH BYTE 
RL E SHIFT NEXT BIT OF DIVIDEND 


7;IF REMAINDER IS 10 OR MORE, NEXT BIT OF 
; QUOTIENT IS 1 (THIS BIT IS PLACED IN CARRY) 


LD A,E 
SUB 10 ;SUBTRACT 10 FROM REMAINIIER 
CCF ;COMPLEMENT CARRY 
> (THIS IS NEXT BIT OF QUOTIENT) 
AR NC, DECCNT ;JLUMP IF REMAINDER IS LESS THAN 10 
LD E,A ;OTHERWISE REMAINDER = DIFFERENCE 
; BETWEEN PREVIOUS REMAINDER AND 10 
ThINZ DVLOOP sCONTINUE UNTIL ALL BITS ARE DONE 
;SHIFT LAST CARRY INTO QUOTIENT 
RL L 7;LAST BIT OF QUOTIENT Ta BIT oO 
RL H 


 ¢ INSERT THE NEXT CHARACTER IN ASCII 
CHINS: 


LD A,E 

ADD A, “O° ;CONVERT O...% TO ASCII “O"...°9" 
CALL INSERT 

IF QUOTIENT IS NOT O THEN FEEP DIVIDING 

Lo A,H 

CIR L 

AR NZ, CNVERT 

LD A, (NGFLAG) 

OR A 

IF F,POS ;BRANCH IF ORIGINAL VALUE WAS POSITIVE 
LD A,o-* 7;ELSE 

CALL INSERT ; PUT A MINUS SIGN IN FRONT 


RET 7 RETURN 


INSERT: 


EXITMR: 


BUFPTR: 
CURLEN: 
NGFLAG: 


<—s =s “s “S ~“S 


SC4SE: 
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t 


IBROUTINE: INSERT 


U 
URPOQSE: INSERT THE CHARACTER IN REGISTER A AT THE 
FRONT QF THE BUFFER 
LENGTH OF BUFFER 
CURRENT ADDRESS QF LAST CHARACTER IN BUFFER 
REGISTER A INSERTED IMMEDIATELY AFTER LENGTH BYTE 


(7 on 


AVE CHARACTER TQ INSERT 


>MOVE ENTIRE BUFFER UP 1 BYTE IN MEMORY 


;GET BUFFER POINTER 
7;HL = SOURCE (CURRENT END OF BUFFER) 


7;DE = DESTINATION (CURRENT END + 1) 
;STORE NEW BUFFER POINTER 


TEST FOR CURLEN = 0 

sJLIMP IF ZERQ (NOTHING TO MOVE, 
; JUST STORE THE CHARACTER) 

7BC = LOOF COUNTER 


;MQVE ENTIRE BUFFER UP 1 BYTE 


y INCREMENT CURRENT LENGTH BY 1 


7;UPDATE LENGTH BYTE CF BUFFER 

s;HL POINTS TQ FIRST CHARACTER IN BUFFER 
sGET CHARACTER TO INSERT 

: INSERT CHARACTER AT FRONT OF BUFFER 
s;RESTORE HL 


ADDRESS OF LAST CHARACTER IN BUFFER 
;CURRENT LENGTH OF BUFFER 


7P 

SENTRY: CURLEN = 

; RUFPTR = 
sEXIT: 

sREGISTERS USED: AF,B,C,0,€ 
PUSH HL 

PUSH AF 

Lo HL, (BUFPTR) 
LD D,H 

Lo E,L 

INC DE 

Lo (BUFPTR) , DE 
LO A, CCURLEN) 
aR A 

JR Z,EXITMR 
Lo CA 

Lo B,O 

LODR 

LO A, (CURLEN) 
INC A 

Lo (CURLEN), A 
Lo (HL), A 

EX DE, HL 

FOP AF 

Lo (HL), A 

POP HL 

RET 

s DATA 

ns 2 

ns i 

ns i 


SAMPLE EXECUTION: 


sCONVERT O Ta “0” 


LD HL, BUFFER 
LD DE, 0 
CALL BN2DEC 


s;SIGN OF GRIGINAL VALUE 


ws “3 “Ss “SS SE 


sHL = BASE ADDRESS OF BUFFER 
7;DE = 0 
; CONVERT 


; BUFFER SHOULD = “O° 
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7;CONVERT 32767 TQ “32767° 

LD HL, BUFFER s;HL = BASE ADDRESS OF BUFFER 

LD DE, 32767 7DE = 32767 © 

CALL BN2DEC 7 CONVERT 

; BUFFER SHOULD = “32767" 

F;CONVERT -—32765 TO “-32765~" 

LD HL, BUFFER s;HL = BASE ADDRESS OF BUFFER 

LD DE, -32768 DE = ~32768 

CALL BN2DEC ; CONVERT 

JR SC4E ; BUFFER SHOULD = “-32768° 
BUFFER: DS 7 77-BYTE BULIFFER 


Conversion of ASCII Decimal to 


Binary (DEC2BN) 


Converts an ASCII string consisting of the 
length of the number (in bytes), a possible 
ASCII — or + sign, and a series of ASCII digits 
to two bytes of binary data. Note that the length 
is an ordinary binary number, not an ASCII 
number. 


Procedure: The program sets a flag if the first . 


ASCII character is a minus sign and skips over a 
leading plus sign. It then converts each subse- 
quent digit to decimal by subtracting ASCII 0, 
multiplies the previous digits by 10 (using the 
fact that 1O=8 + 2,so0a multiplication by 10 can 
be reduced to left shifts and additions), and adds 
the new digit to the product. Finally, the pro- 
gram subtracts the result from 0 if the original 
number was negative. The program exits imme- 
diately, setting the Carry flag, if it finds some- 


Entry Conditions 


Base address of string in HL 


Examples 


1. Data: String consists of 


04 (number of bytes in string) 
31 (ASCII 1) 
32 (ASCII 2) 
33 (ASCII 3) 
34 (ASCII 4) 


That is, the number is +1,234,, 


Ar 


Registers Used: AF, BC, DE, HL 
Execution Time: Approximately 152 cycles per byte 
plus a maximum of 186 cycles overhead 
Program Size: 79 bytes 
Data Memory Required: One byte anywhere in 
RAM (address NGFLAG) for a flag indicating the 
sign of the number 
Special Cases: 

1. If the string contains something other than a 
leading sign or a decimal digit, the program returns 


with the Carry flag set to 1. The result in HL is 
invalid. 


2. If the string contains only a leading sign 
(ASCII + or ASCII —), the program returns with 
the Carry flag set to 1 and a result of 0. 





thing other than a leading sign or a decimal digit 
in the string. 


Exit Conditions 


Binary value in HL 

Carry flag is 0 if the string was valid; Carry flag 
is | if the string contained an invalid charac- 
ter. 

Note that the result is a signed two’s complement 
16-bit number. 


Result: (H) = 04;¢ (more significant byte of binary 
data) 
(L) = D2j¢ (less significant byte of binary 
data) 


That is, the number + 1,234) = 04D21¢ 
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2. Data: String consists of Result: (H) = 80,6 (more significant byte of binary 

data) 

BH Sch = pace stele) (L) = 12j¢ (less significant byte of binary 

data) 

- pee 7‘ That is, the number —32,750)9 = 8012)¢ 

37 (ASCII 7) | 

35 (ASCII 5) 

30 (ASCII 0) 


That is, the number is —32,750,9 


us206"s ws SS NB NH US SS 
—w<s “~S “8S “SSB “NS US NS SS 


Registers used: AF, BC, DE, HL 


Title Decimal ASCII to binary 
Names DECZBN 

7 Purpose: Convert ASCII characters to two bytes of binary : 
: data : 
Entrys HL = Base address af input buffer . 
Exits HL = Binary value : 
if no errors then : 
Carry = 0 : 
else ; 
Carry = Il ; 


Times Approximately 152 cycles per byte plus 
a maximum of 186 cycles overhead 


Sizes: Program 79 bytes 
Data 1 byte 


“ws “8 “8 “SB “8S NS NS 4S Me NS SH NR NE OWE NE NS NS 
—s “8 we we wa MS 


—s 


DEC2BN: 
INITIALIZE - SAVE LENGTH, CLEAR SIGN AND VALUE 
LD A, CHL) 7; SAVE LENGTH IN B 
LD B,A | 
INC HL. POINT TO BYTE AFTER LENGTH 
SUB A 
Lo C(NGFLAG),A 7;ASSUME NUMBER IS POSITIVE 
LD DE, 0 7;S7TART WITH VALUE = 0 


7;CHECK FOR EMPTY BUFFER 
OR B 715 BUFFER LENGTH ZERO’? 


INIT1: 


PLUS: 


SKIP: 


CNVERT : 


CHEDIG: 


AE CONVERSION OF ASCII DECIMAL TO BINARY (DEC2BN) 485 


JR Z,EREXIT ;YES, EXIT WITH VALUE = 0 


;CHECK FOR MINUS OR PLUS SIGN IN FRONT 


LD A, (HL) 7;GET FIRST CHARACTER 

CP = 715 IT A MINUS SIGN? 

JR NZ, PLUS ;NQ, BRANCH 

LD A, OFFH 

LD (NGFLAG),A ;YES, MAKE SIGN OF NUMBER NEGATIVE 
JR SKIP 7;SKIP QVER MINUS SIGN 

CP ie ol S FIRST CHARACTER A PLUS SIGN? 


et 
IR NZ,CHKDIG 7;NQ, START CONVERSION 

INC HL. 7;SKIP QVER THE SIGN BYTE 

DEC B ;DECREMENT COUNT 

JR Z,EREXIT ;ERROR EXIT IF ONLY A SIGN IN BUFFER 


7 CONVERSION LOOP 
; CONTINUE UNTIL THE BUFFER IS EMFTY 
7; OR A NON-NUMERIC CHARACTER IS FOUND 


LO A, CHL) ;GET NEXT CHARACTER 

SUE “O° 

JR C,EREXIT ERROR IF < “O”% (NOT A DIGIT) 
CP +1 

JR NC, EREXIT ;ERROR IF > “9” (NOT A DIGIT) 
LD C,A ;CHARACTER IS DIGIT, SAVE IT 


7;VALIO DECIMAL DIGIT SO 
VALUE == VALUE ® 10 
= VALUE = (& + 2) 
= (VALUE ® 8) + (VALUE ® 2) 


e «wa “a 


PUSH HL ;SAVE BUFFER POINTER 
EX DE, HL FHL = VALUE 

ADD HL, HL 7; = 2 

LD E,t ;SAVE TIMES 2 IN DE 
LD D,H 

ADD HL, HL 2 # 4 

ADD HL, HL 7; # & 

ADD HL, DE VALUE = VALUE ® (3+2) 


7;ADD IN THE NEXT DIGIT 
; VALUE := VALUE + DIGIT 


LD E,C ;MOVE NEXT DIGIT TQ E 

LO 0,90 ; HIGH BYTE IS 0 

ADD HL, DE FADD DIGIT TO VALUE 

EX DE, HL 7DE = VALUE 

POP HL. 7;PQINT TO NEXT CHARACTER 
INC HL 

DUNZ CNVERT CONTINUE CONVERSION 
7;CONVERSTION IS COMPLETE, CHECK SIGN 

EX DE, HL 7HL = VALUE 

LD A, (NGFLAG) 


OR A 
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JR Z,QKEXIT sJLUMP IF THE VALUE WAS POSITIVE 
EX DE, HL ©ELSE REPLACE VALUE WITH —-VALLUE 
LO HL, © 
OR A sCLEAR CARRY 
SBC HL, DE *SUBTRACT VALLIE FROM O 
*NOQ ERRORS, EXIT WITH CARRY CLEAR 
QKEXIT: 
OR A sCLEAR CARRY 
RET 
*AN ERROR, EXIT WITH CARRY SET 
EREXIT: 
EX DE, HL ®*HL = VALUE 
SCF sSET CARRY TQ INDICATE ERROR 
RET 
*DATA 
NGFLAG: OS 1 sSIGN QF NUMBER 
; SAMPLE EXECUTION: 
SC4F = 
sCONVERT “1234° 
LO HL, Sil sHL = BASE ADDRESS OF 31 
CALL DECZEN 
sH = 04, L = D2 HEX 
sCONVERT “+32767° 
LO HL, S2 sHL = RASE ADDRESS OF 32 
CALL NECZEN 
*H = 7F, L = FF HEX 
sCQONVERT %“-32763"% 
LD HL,S3 ‘HL = BASE ADDRESS OF S33 
CALL DECZEN 
sH = 80 HEX, L = OO HEX 
JR SC4F 
Si: DB 4,°1234°" 
S2: DOB 6, °+32767°" 
$3: DR 4, °-32768" 


END 


“us “8 “6 “SB WS 


Lower-Case to Upper-Case 


Translation ((C2UC) 


Converts an ASCII lower-case letter to its 
upper-case equivalent. 

Procedure: The program uses comparisons to 
determine whether the data is an ASCII lower- 
case letter. If it is, the program subtracts 2016 
from it, thus converting it to its upper-case equiv- 
alent. If itis not, the program leaves it unchanged. 


Entry Conditions 


Character in A 


AGS 


Registers Used: AF 


Execution Time: 45 cycles if the original character is 
a lower-case letter, fewer cycles otherwise 


Program Size: 11 bytes 
Data Memory Required: None 





Exit Conditions 


If an ASCII lower-case letter is present in A, 
then its upper-case equivalent is returned in A. 
In all other cases, A is unchanged. 


Examples 
1. Data: (A) = 62,6 (ASCII b) 2. Data: (A) = 54), (ASCII T) 
Result: (A) = 42,, (ASCII B) Result: (A) = 54,, (ASCII T) 
: Title Lower-case to upper-case translation : 
’ Name: LO2uc ; 
Furpoase: Canvert ane ASCII character to upper case from 


Entrys Register A = 


Exits Register A = 


“ss “8 “8s “SQ “SQ “SS uh WS NSB OS 


Registers used: AF 


Loawer~-case ASCII character 


Upper-case ASCII character if A 


is lower 


lower case if necessary 


rage, 


else A is unchanged 


ws “8S “Ss “8 ws “SS se us “we 
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“us “8s “8S “ws “Ss SS NS 


rc 
rl 
ie) 
as 
my 
as 


EXIT: 


~—e “a@ “8S “SB A 


Sc4c: 


Times 45 cycles if A is lawer case, less atherwise 
Size: Pragram 11 bytes 
Data none 
CP “a? 
JR C,EXIT * BRANCH IF < “’a’* (NOT LOWER CASE) 
CF “Z°+) 
JR NC, EXIT sBRANCH IF > “2” CNOT LOWER CASE) 
SUB “av-"A” *CHANGE “’av”..°2°% into “A%..°Z" 
RET 


SAMPLE EXECUTION: 


;CONVERT LOWER CASE E TO UPPER CASE 


LD A,“e* 

CALL LC2uc ;A="E°=435H 
?CONVERT LOWER CASE Z TO UPPER CASE 
LD A,°2° 

CALL LC2uc sA="Z°=S5AH 
7;CONVERT UPPER CASE A TO UPPER CASE A 
LD A,“A”% 

CALL LC2uc 7;A="A°=41H 

JR SC4G 


=—s “sae “ue “SS M8 UNS 6S 


“~ws 68 VS ONS NS 


ASCIl to EBCDIC Conversion (ASC 2EB) AH 


Converts an ASCII character to its EBCDIC 
equivalent. 

Procedure: The program uses a simple table 
lookup with the data as the index and address 
EBCDIC as the base. A printable ASCII charac- 
ter with no EBCDIC equivalent is translated to 
an EBCDIC space (4016); a non-printable ASCII 
character with no EBCDIC equivalent is trans- 
lated to an EBCDIC NUL (0046). 


Entry Conditions 


ASCII character in A 


Examples 
1. Data: (A) = 35). (ASCII 5) 
Result: (A) = F5,¢ CEBCDIC 5) 


2. Data: (A) = 7716 (ASCII w) 
Result: (A) = A6,¢ (EBCDIC w) 


we ~S ss “Ss “8 48 WE SS 


Registers Used: AF, DE, HL 
Execution Time: 55 cycles 


Program Size: !1 bytes, plus 128 bytes for the con- 
version table 


Data Memory Required: None 





Exit Conditions 


EBCDIC equivalent in A 


Data: (A) = 2Aj¢ (ASCII *) 
Result: (A) = 5C\¢ (EBCDIC *) 


Ty ee ee ee) ee ee ee 


Title ASCII te EBCDIC conversian 

Name: ASCZEB 
: Furpases Convert an ASCII character ta its ; 
: carresponding EBCDIC character ; 
: Entrys Register A = ASCII character : 
: Exits Register A = ERCDIC character. ; 
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“es 


“ue “6 us ws “ws “8S WS 4S 


ASC2EB: 


(Ti « ws ws “es 


BCDICs 


Registers used: AF, DE, HL 


Times 


Sizes: 


LO 
RET 


a 
r 


DB 


DB 


DB 


DB 


so cycles 


Program il bytes 


Rata 128 bytes far the table 
HL,EBCDIC °GET BASE ADDRESS OF EBCDIC TAELE 
O1L11111B6 *BE SURE BIT 7 = 6 
E,A sUSE ASCII AS INDEX INTO EBCODIC TABLE 
n,o0 
HL, DE 
A, CHL) sGET EBCRIC 


ASCII TO EBCDIC TABLE 
A PRINTABLE ASCII CHARACTER WITH NO EBCDOIC EQUIVALENT IS 
TRANSLATED TO AN EBCDIC SPACE (040H), 
WITH NO EQUIVALENT IS TRANSLATED TO A EBCDIC NUL COOOH) 


NUL SOH STX ETX EOQT EN@® ACK BEL 
000H, 001H, 002H, 003H, 037H, O2ZDH, OZEH, O2FH 
BS HT LF VT FF CR vt a SI 
016H, OOSH, O25H, OOBH, OOCH, OODH, OOEH, OOFH 
DLE DbCi DC2 Des OC4 NAK SYN ETB 
O10H, OL1H, O12H, O13H, OSCH, O3DH, O32H, O26H 


CAN EM SUB ESC IFS IG65 IRS [us 

O1S8H, O19H, OSFH, 027H, O1CH, O1DH, O1EH, O1FH 

SPACE ! _ # $ ‘te &. 

040H, OSAH, O7FH, O7 BH, OSBH, O6CH, OSOH, OODH 
¢ ) x + / 

O4DH, OSDH, OSCH, a O&BH, OOH, O4BH, O61H 
0 1 yy 4 bal & 7 

OF OH, ne OF 2H, OF SH, OF 4H, OF SH, VE ote man 
Ss 2 < 


OF SH, Broil; O7AH, OSEH, O4CH, O7EH, O8EH, O6FH 
@ A B C D E F G 
O7CH, OC1H, ee OCS3H, OC 4H, OCSH, OC6H, OC7H 
H I K L. M N Q 
OCSH, OCIH, ob1H, OD2H, OD 3H, OD4H, ODSH, ODGH 
F Q R 3 T ul V W 
OD7H, ODSH, OD9H, OE2H, OE 3H, OE4H, OESH, OESH 


xX Y Z C \ J 
0E7H, OESH, OE9H, 040H, OEOH, 040H, 040H, O6DH 
: a b c d 2 f g 
OO9H, OS1H, O82H, OS3H, O84H, OSSH, OSSH, O87H 
h i J k l m n o 
O8SH, OS9H, O91H, OF2H, OF 3H, OF 4H, OFSH, ha 
Pp q Yr S t u v 
097H, O9SH, OF9H, OAZH, OASH, OA4H, OASH, OAGH 
x Y z { : 3 DEL 


OA7H, OASH, OAGH, OCOH, OGAH, ODOH, OALH, 007H 


A NONPRINTABLE ASCII CHARACTER 


ASCII 
sEBCDIC 
ASCII 
sEBCDIC 
2ASCII 
sEBCDIC 
sASCTI 
sEBCDIC 
-ASCIT 
sEBCDIC 
ASCII 
sEBCDIC 
sASCII 
sEBCDOIC 
sASCII 
sEBCDRIC 
s;ASCII 
sEBCDIC 
sASCII 
sEBCDIC 
ASCII 
sEBCDIC 
sASCII 
sEBCDIC 
2ASCITI 
sEBCDIC 
ASCII 
sEBCDIC 
sASCII 
sEBCOIC 
, ASCII 
sEGCODIC 


“usa “es “SS MB ONS MS UME UME OE 


“ua 6“S8 SS WB OMS 


if 


C4H: 


AH ASCII TO EBCDIC CONVERSION (ASC 2EB) 


SAMPLE EXECUTION: 


sCONVERT ASCII 
LO A, “A” 
CALL ASC: ZEB 


CONVERT ASCII 
LD A,“1" 
CALL ASC2EB 
;CONVERT ASCII 
LD A,“a” 
CALL ASC2ERB 
AR SC4H 


END 


“A” TO EBCDIC 


SASCII “A“ 
sEBCDIC ‘A’ 


“1° TQ EBCDIC 


y,ASCITI “1° 
s;EBCDIC “1° 


Ya’ TQ EBCDIC 


sASCII ‘a’ 
sEBCDIC ‘a’ 


OC1H 


OF 1H 
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“ws “86 “WB USB ME 


EBCDIC to ASCII Conversion (EB?ASC) Al 


Converts an EBCDIC character to its ASCII 
equivalent. Registers Used: AF, DE, HL 

Procedure: The program uses a simple table Execution Time: 48 cycles 
lookup with the data as the index and address Program Size: 9 bytes, plus 256 bytes for the con- 
ASCllas the base. A printable EBCDIC charac- | Yoon ‘able . 
ter with no ASCII equivalent is translated to an PC ene pecker 
ASCII space (206); a non-printable EBCDIC 
character with no ASCII equivalent is trans- 
lated to an ASCIT NUL (004¢). 





Entry Conditions Exit Conditions 
EBCDIC character in A ASCII equivalent in A 
Examples 
1. Data: (A) = 85)¢ (EBCDIC e) 2. Data: (A) = 4E;, (EBCDIC +) 
Result: (A) = 65,6 (ASCII e) Result: (A) = 2B,, (ASCII +) 
: Title EBCDIC ta ASCII conversian : 
: Names EBZ2ASC : 
Furpases Convert an EBCDIC character ta its 


corresponding ASCII character 


Entrys Register A EBCDIC character 
Exits Register A = ASCII character 


Registers used: AF,DE,HL 


“w66"s8 “Ss “8 owS “SB 06S USS UNS ONS 
a] i, ee i ee et | et et ey 
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Al EBCDIC TO ASCII CONVERSION (EB2ASC) 493 


Times 43 cycles 


Size: Pragram 9 bytes 
Data 256 bytes far the table 


“seo6"“s “8 “EB “SB SS 
“wi ous wa “ws “sSe we 


Mm 
to 
hh 
> 
iH 
an 
as 


LD HL, ASCII ;GET BASE ADDRESS OF ASCII TABLE 
LD E,A sUSE ERCDIC AS INDEX 
LD n,o 
AnD HL, DE 
LD A, CHL) ;GET ASCII CHARACTER 
RET 

sEBCDIC TO ASCII TABLE 

: A PRINTABLE EBCDIC CHARACTER WITH NQ ASCII EQUIVALENT IS 

; TRANSLATED TQ AN ASCII SPACE (020H), A NONPRINTABLE EBCDIC CHARACTER 

; WITH NO EQUIVALENT IS TRANSLATED TO AN ASCII NUL (OOOH) 

ASCII: 
; NUL SQH STX ETX HT DEL sEBCDIC 
DB OOOH, 001H, 002H, 003H, OOOH, 0O09H, OOOH, O7FH sASCII 
; VT FF cR $0. §&I sEBCDIC 
DB Q00H, O00H, O00H, OOBH, OOCH, OODH, OOEH, OOFH sASCII 
; DLE noci oc2 nc3 RS sEBCDIC 
DB O10H, O11H, O12H, 013H, OOOH, OOOH, 008H, 000H sASCII 
; CAN EM IFS IGS IRS Ius sEBCDIC 
DB 018H, 019H, OOOH, OOOH, O1CH, O1DH, OLEH, O1FH sASCII 
; LF ETB ESC sEBCDIC 
DB Q00H, 000H, O00H, 000H, OOOH, OOAH, 017H, O1BH sASCII 
; ENQ@ ACK BEL sEBCDIC 
DB OOOH, OOOH, OOOH, O00H, OOOH, OOSH, O04H, 007H sASCII 
; SYN EQT sEBCDIC 
DB OQ0H, 000H, 014H, OOOH, OOOH, OOOH, OOOH, 004H sASCII 
; nc4 NAK SUB sEBCDIC 
LIB OOOH, O00H, O00H, OOOH, 014H, O15H, OOOH, O1AH sASCII 
; SPACE sEBCDIC 
IB * ¥ ,Q00H, OOOH, O00H, 0O0H, OOOH, OOOH, OOOH FASCTI 
; : < ( + sEBCDIC 
DR OO0OH,O00H,% % ,7.7 7°77 4 °C% 4 *H% 4% 7% sASCII 
; &. sEBCDIC 
DB “&" ,O00H, OOOH, O00H, OOOH, OOOH, OOOH, OOOH sASCII 
be ! $ ie ) ; sEBCDIC 
ng OOOH) :000H; 71° 7° $%" 478" 9) ore at * sASCII 
; = / sEBCDIC 
DB vv’ ,%/% ,Q00H, OOOH, OOOH, OOOH, O00H, OOOH sASCII 
; ; % ~ > ? sEBCDIC 
DB OOOH LO00H 7 1? 975 GR? 44S" 49>? oo? sASCII 
; sEBCDIC 
DB Q00H, OOOH, OOOH, O00H, OOOH, OOOH, O00H, OOOH sASCII 
; 2 : # @ = " sEBCDIC 
DB OOOH, **” re aad 5 Re ,’a@- eet ee panes sASCII 
; a b c d e f g sEBCDIC 
DB OOOH; "a? .(b° 4%e" 9rd? ¢%e" 2°t° 3°98" sASCII 


; h i ;EBCOIC 


494 CODE CONVERSION 


“wa 6 “8 “sa “Ss NS 


SC41Is: 


DB hh’ ,*i% ,O0O0H 
; J k 
DB QO0OH, “j% 7k?’ 
; q r 

DB “q° ,“r* ,Q00H 
; - S 
DB OOOH, 77" 7s?’ 
? Y = 

DB “y" ,%2z° ,QQ0H 
DB O00H, OOOH, OO0H 
DB QO00H, Q0O0H, QQ0H 
; { & B 
DB Pod { ” y ” A” ; “ B ” 

; H I 

DB "“H" ,“I% ,QQ0H 
? $ ul K 
DB ne Cd oe 
; Q R 

DB “O° ,°R* ,Q0O0H 
; \ S$ 
DB “\%  ,QO0H, “S°* 
; ¥ Z 

DB “¥" ,°Z"% ,Q0Q0H 
? 8) 1 2 
ne or eae 5° 3r 
; 9 

DB "9" ,O00H, OOOH 


SAMPLE EXECUTION: 


CONVERT EBCDIC “A’ TO 


LO A, OC1H 

CALL EB2ASC 
;CONVERT EBCDIC “1” TQ 
LO A,OF 1H 

CALL EB2ASC 
;CONVERT EBCDIC “a” TO 
Lo A,O81H 

CALL EB2ASC 

AR SC4I 


END 


Ra al Pad oe & rd 
Sa t + u r V 


» OOOH, OOOH, OOOH, OO0H, OOOH 
1 m n a Pp 
mae Fd 7m’ ‘ “nn? ; Ya’ of -ed 
, QO00H, OOOH, O0O0H, 000H, O00H 
t u Vv Ww x 


” ” “ Pod 
r WwW, x 


, OOOH, OOOH, 000H, OOOH, OOOH 


, 000H, OOOH, O00H, OOOH, OOOH 


r 900H, OOOH, O00H, OO0H, OOOH 


C D E F G 
Ped We Pee fl Mae » °F? »’ G" 


, 900H, O00H, 000H, OOOH, OOOH 
i M N Q P 


: “LL? 7 “M’ 7 “NY : “Q’ : “pe 


, O00H, 000H, 000H, O00H, OOOH 


T u V W X 


ieee fa 5 Pa! ; “WW, eee ead 


, 900H, 000H, 000H, OOOH, OOOH 
3 4 — é 7 
Paes ol aie ot ; aie ad ; a 5 ie fod 


, 000H, 000H, 000H, 000H, OOOH 


ASCII 
sEBCDIC “A” 


s;ASCII “A = O41H 
ASCII 

s;EBCDIC “1° 

,ASCIT “1° = O31H 


ASCTI 
7;EBCDIC “a” 
7ASCITI “a” = OG1H 


s;ASCII 
sEBCDIC 
sASCII 
sERCDIC 
;ASCTII 
sEBCDIC 
sASCII 
s;EBCDIC 
sASCII 
sEBCDIC 
sASCTII 
sEBCDIC 
sASCII 
sEBCDIC 
sASCTI 
sEBCDIC 
sASCTII 
sEBCDIC 
sASCTII 
sEBCDIC 
sASCTII 
sEBCOIC 
sASCTII 
sEBCDIC 
sASCITI 
sEBCDIC 
ASCII 
sEBCDIC 
sASCII 


~“~s 6S 6“SG ER ONS 


Memory Fill (MFILL) 


Places a specified value in each byte of a mem- 
ory area of known size, starting at a given ad- 
dress. 

Procedure: The program stores the specified 
value in the first byte and then uses a block move 
to fill the remaining bytes. The block move 
simply transfers the value a byte ahead during 
each iteration. 


Entry Conditions 


Starting address of memory area in HL 
Area size (number of bytes) in BC 


Value to be placed in memory in A 


Examples 


1. Data: Value= FF, 
Area size (in bytes) = 038016 


Base address = LAE0j¢ 


FF \¢ placed in addresses 1AE0,¢ through 
LESFi¢ 


Result: 


OA 


Registers Used: AF, BC, DE, HL 


Execution Time: Approximately 21 cycles per byte 
plus 50 cycles overhead 


Program Size: 11 bytes 
Data Memory Required: None 
Special Cases: 


1. Asize of 0000,¢ is interpreted as 10000/¢. It there- 
fore causes the program to fill 65,536 bytes with 
the specified value. 


. Filling areas occupied or used by the program 
itself will cause unpredictable results. Obviously, 
filling the stack area requires special caution, 
since the return address is saved there. 





Exit Conditions 


The area from the base address through the 
number of bytes given by the area size 1s filled 
with the specified value. The area thus filled 
starts at BASE and continues through BASE + 
SIZE — 1 (BASE is the base address and SIZE 1s 
the area size). 


2. Data: Value = 00), (Z80 operation code for NOP) 
Area size (in bytes) = 1C65i¢ 
Base address = E34Cj¢ 
Result: 00,6 placed in addresses E34C,,¢ through 


FFBO i, 
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496 ARRAY MANIPULATION 


=a 68 “we “8 WS WS SUS SE 


Title Memary fill 

Name: MFILL 

Purpose: Fill an area of memory with a value 
Entry: Register H High byte af base address 


Low byte af base address 
High byte of area size 

Low byte of area size 

Value to be placed in memory 


Register L 
Register B 
Register C 
Register A 


Hun nou 


Note: A size of 0 is interpreted as 65536 
Exits Area filled with value 
Registers used: AF,BC,DE, HL 


Time: Approximately 21 cycles per byte plus 
20 cycles overhead 


=e “wa ws “ES uS us ME USS SS NS Se ws SS NE Ne NS NH SS UNE UNS USS 


Sizes: Program 11 bytes 
Data None 
MFILL: 
LD CHLD,A sFILL FIRST BYTE WITH VALUE 
LD D,H sDESTINATION PTR = SQURCE PTR + 1 
LD E,L 
INC DE 
DEC BC sELIMINATE FIRST BYTE FROM COUNT 
LD A,B sARE THERE MORE BYTES TO FILL? 
OR Cc 
RET Z *>NQ, RETURN ~— SIZE WAS 1 
LDIR ‘YES, USE BLOCK MOVE TO FILL REST 
+: BY MOVING VALUE AHEAD 1 BYTE 
RET 
? 
; SAMPLE EXECUTION: 
SCSA: 


7;FILL BF1 THROUGH BF1i+15 WITH 00 
LD HL, BF 1 7;STARTING ADDRESS 
LD BC,SIZE1 ;NUMBER OF BYTES 


=e 68 6S w8 NS we WA NE 


—8 ws us uA we NS UE ONS UNE UNS NE US OE 


~8 ~s ~S 


“ews ws “8 we wes 


ws vs “6 SS WE 


SIZE1 
SIZE2 
BF 1: 
BF2: 


5 MEMORY FILL(MFILL) 497 


LD A,90 sVALUE TO FILL 

CALL MFILL s;FILL MEMORY 

;FILL BF2 THROUGH BF2+1999 WITH FF 

LD HL, BF2 ?STARTING ADDRESS 

LD BC, SIZE2 sNUMBER OF BYTES 

LD A, OFFH ;VALUE TQ FILL 

CALL MFILL 7;FILL MEMORY 

JR SCSA 

EQU 16 ;SIZE OF BUFFER 1 (10 HEX) 
EQU 2000 ;SIZE OF BUFFER 2 (O7D0 HEX) 
DS SIZE1 

DS SIZE2 


END 


Block Move (BLKIOV) 


Moves a block of data from a source area to 
a destination area. 

Procedure: The program determines if the 
base address of the destination area is within the 
source area. If it is, then working up from the 
base address would overwrite some source data. 
To avoid overwriting, the program works down 
from the highest address (this is sometimes called 
a move right). If the base address of the destina- 
tion area is not within the source area, the 
program simply moves the data starting from 
the lowest address (this is sometimes called a 
move left). An area size (number of bytes to 
move) of 0000;¢ causes an exit with no memory 
changed. The program provides automatic ad- 
dress wraparound mod 64K. 


Entry Conditions 


Base address of source area in HL 
Base address of destination area in DE 


Number of bytes to move in register BC 


Examples 


1. Data: Number of bytes to move = 02004, 
Base address of destination area = 05D1 4 


Base address of source area = 035E i 


Result: The contents of locations 035E,,¢ through 
055D,, are moved to O05Dlj.¢ through 


07D0,6 
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OB 


Registers Used: AF, BC, DE, HL 


Execution Time: 21 cycles per byte plus 97 cycles 
overhead if data can be moved starting from the 
lowest address (i.e., left) or 134 cycles overhead if 
data must be moved starting from the highest 
address (i.e., right) because of overlap. 


Program Size: 27 bytes 


Data Memory Required: None 


Special Cases: 


1. Asize (number of bytes to move) of 0 causes an 
immediate exit with no memory changed. 


2. Moving data to or from areas occupied or used 
by the program itself or by the stack will have 
unpredictable results. 


Exit Conditions 


The block of memory is moved from the source 
area to the destination area. If the number of 
bytes to be moved is NBYTES, the base address 
of the destination area is DEST, and the base 
address of the source area is SOURCE, then the 
data in addresses SOURCE through SOURCE 
+ NBYTES — I is moved to addresses DEST 
through DEST + NBYTES — 1. 


2. Data: Number of bytes to move = IB7Aj¢ 
Base address of destination area = C946), 
Base address of source area = C3004 
Result: The contents of locations C300,¢ through 


DE79;, are moved to C946,, through 
E4BFi¢ 


5B BLOCK MOVE (BLKMOV) 499 


Note that Example 2 is a more difficult prob- This would destroy the old contents of C946yj¢, 
lem than Example | because the sourceanddes- _whichare needed later in the move. The solution 
tination areas overlap. If, for instance, the pro- to this problem is to move the data starting from 
gram were simply to move datatothedestination the highest address if the destination area 1s 
area Starting from the lowest address, it would above the source area but overlaps it. 
initially move the contents of C300 6 to C9466. 


“=e ~s we wea ~we “<8 SS UE 
~e wes “6 “8S we “WS WS WA 


Title Block Move 

Name: BLKMOV 

Purposes: Move data fram source to destination 

Entry: Register*H = High byte of source address 
Register L = Law byte of source address 
Register D = High byte of destinatian address 
Register E = Low byte of destination address 
Register B = High byte of number of bytes to move 
Register C = Law byte of number of bytes to move 

Exits Data moved from socurce to destinatian 


Registers used:AF,BC, DE, HL 


Times: 21 cycles per byte plus 97 cycles averhead 
if no overlap exists, 134 cycles overhead 
if overlap occurs 


2 "8 we “GE we we VS WE ONS wR UNS UNE WS UWB UR UR UME USAR SA lS Se 
ee) ee ee ee ee |) | 


Sizes: Program 27 bytes 
BLKMOV: 
LD A,B sIS SIZE OF AREA 07? 
OR Cc 
RET Z s;YES, RETURN WITH NOTHING MOVED 


;DETERMINE IF DESTINATION AREA IS ABOVE SOURCE AREA AND OQVERLAPS 
IT (QVERLAP CAN BE MOD 64K). OQVERLAP OCCURS IF 

STARTING DESTINATION ADDRESS MINUS STARTING SQURCE ADDRESS 

; (MOD 64K) IS LESS THAN NUMBER OF BYTES TO MOVE 

EX DE, HL s;CALCULATE DESTINATION —- SOURCE 

PUSH HL 7;SAVE DESTINATION 

AND A 7;CLEAR CARRY 


ewe “6 


200 array MANIPULATION 


DOLEFT: 


we “ue WES SS OS 


SOURCE 
DEST 
LEN 


SCSB: 


SBC 
AND 
SBC 
POP 
EX 
JR 


HL, DE 

A 3 THEN SUBTRACT AREA SIZE 

HL, BC 

HL s;RESTORE DESTINATION 

DE, HL 

NC, DOLEFT ;JUMP IF NO PROBLEM WITH OVERLAP 


;DESTINATION AREA IS ABOVE SOURCE AREA AND OVERLAPS IT 
;MOVE FROM HIGHEST ADDRESS TO AVOID DESTROYING DATA 


ADD 
DEC 
EX 
ADD 
DEC 
EX 
LDDR 
RET 


HL, BC s;SQURCE = SOURCE + LENGTH - 1 
HL 
DE, HL sDEST = DEST + LENGTH - 1 
HL, BC 
HL 
DE, HL 
;BLOCK MOVE HIGH TO LOW 


s;QRDINARY MOVE STARTING AT LOWEST ADDRESS 


LDIR 
RET 


;BLOCK MOVE LOW TQ HIGH 


SAMPLE EXECUTION: 


EQU 
EQU 
EQu 


2000H 7;BASE ADDRESS OF SOURCE AREA 
2010H 7BASE ADDRESS OF DESTINATION AREA 
11H ;NUMBER OF BYTES TO MOVE 


7;MOVE 11 HEX BYTES FROM 2000-2010 HEX TO 2010-2020 HEX 


HL, SOURCE 

DE, DEST 

BC,LEN 

BLKMOV ?>MOVE DATA FROM SOURCE TO DESTINATION 


SCSB 


see “a 6"sS “SS ws 


Two-Dimensional Byte Array 


Indexing (D2BYTE) 


Calculates the address of an element of a 
two-dimensional byte-length array, given the 
base address of the array, the two subscripts of 
the element, and the size of a row (that is, the 
number of columns). The array is assumed to be 
stored in row major order (that is, by rows) and 
both subscripts are assumed to begin at 0. 

Procedure: The program multiplies the row 
size (number of columns in a row) times the row 
subscript (since the elements are stored by rows) 
and adds the product to the column subscript. It 
then adds the sum to the base address. The 
program performs the multiplication using a 


Entry Conditions 


Order in stack (starting from the top) 


Less significant byte of return address 
More significant byte of return address 


Less significant byte of column subscript 
More significant byte of column subscript 


Less significant byte of the size of a row (in bytes) 
More significant byte of the size of a row (in bytes) 


Less significant byte of row subscript 
More significant byte of row subscript 


Less significant byte of base address of array 
More significant byte of base address of array 


Examples 


1. Data: Base address = 3C00j, 
Column subscript = 000416 
Size of row (number of columns) = 0018), 


Row subscript = 000316 


OC 





Registers Used: AF, BC, DE, HL 


Execution Time: Approximately 1100 cycles, de- 
pending mainly on the amount of time required to 
perform the multiplication. 


Program Size: 44 bytes 


Data Memory Required: Four bytes anywhere in 
memory to hold the return address (two bytes start- 
ing at address RETADR) and the column subscript 
(two bytes starting at address SS2). 





standard shift-and-add algorithm (see Subrou- 
tine 6A). 


Exit Conditions 


Address of element in HL 


Result: | Element address = 3C00j¢ + 0003,¢ * 0018), + 


00041, = 3C001 + 0048,, + 0004,. = 
3C4C 


That is, the address of ARRAY(3,4) is 3C4Cj¢ 
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Note that all subscripts are hexadecimal Result: Element address= 6A4A¢+ 0002), * 00501.+ 
‘ 16 
The general formula is That is, the address of ARRAY(2,35) is 
ELEMENT ADDRESS = ARRAY BASE OBIF i¢ 
ADDRESS + ROW SUBSCRIPT * ROW SIZE 
+ COLUMN SUBSCRIPT Note that we refer to the size of the row sub- 
script; the size is the number of consecutive 
memory addresses for which the subscript has 
the same value. This is also the number of bytes 
2, Data: — Base address = 6A4Aj¢ from the starting address of an element to the 
Column subscript = 0035,, ‘ dd fans! ‘th th 
Size of row (number of columns) = 0050; Starting a rae of the element bi the same 
Row subscript = 0002), column subscript but a row subscript one larger. 
; Title Two-dimensional byte array indexing ; 
; Name: D2BYTE ; 
Purposes Given the base address of a byte array, two 


subscripts “I°,’J%, and the size of the first 

subscript in bytes, calculate the address of 

ACI,J]. The array is assumed to be stored in 

row major order (ALO,0], ALO,1],..., ACK,LI), 

and both dimensions are assumed to begin at 

zero as in the following Pascal declaration: 
A: ARRAYCO..2,0..7] OF BYTE; 


Entry: TOP OF STACK 
Low byte of return address, 
High byte of return address, 
Low byte of second subscript (column element), 
High byte of second subscript (column element), 
Low byte of first subscript size, in bytes, 
High byte of first subscript size, in bytes, 
Law byte of first subscript (row element), 
High byte of first subscript (row element), 
Low byte of array base address, 
High byte of array base address, 
NOTE: 
The first subscript size is length of a row 
in bytes 


we «we UvrlUSS UNS UNS UME UR US UMS wR NS A 


=a 6<e@ “8 “8 we we wes wS8 we WS MS UNH ONE SR UME UME UNA SS MR NE USE UNS SS NE 


ue oss “8s “ea ~we “ws we “we “A we VS NS 


5C TWO-DIMENSIONAL BYTE ARRAY INDEXING (D2BYTE) 2O3 


High byte of element address 
Low byte of element address 


Exits Register H 
Register L 


Registers used: AF,BC,DE, HL 


Times Approximately 1100 cycles 
Sizes Program 44 bytes 
Data 4 bytes 


“us 6 ~8 wae “we ~ws “Ss ws 48 WR WE NE 
we 6“e we wR we VS NS MR Ne we OE 


D2BYTE: 
sSAVE RETURN ADDRESS 
POP HL. 
LD CRETADR), HL 
sGET SECOND SUBSCRIPT 
POP HL. 
LD ($SS2),HL 
sGET SIZE OF FIRST SUBSCRIPT (CROW LENGTH), FIRST SUBSCRIPT 
POP DE sGET LENGTH OF ROW 
POP BC sGET FIRST SUBSCRIPT 
sMULTIPLY FIRST SUBSCRIPT # ROW LENGTH USING SHIFT AND ADD 
: ALGORITHM. PRODUCT IS IN HL 
LD HL,9O sPRODUCT = 0 
LO A,153 sCQOUNT = BIT LENGTH - 1 
MLP: 
SLA E SHIFT LOW BYTE OF MULTIPLIER 
RL D sROTATE HIGH BYTE OF MULTIPLIER 
JR NC,MLP 1 sJUMP IF MSB OF MULTIPLIER = 0 
ADD HL, BC sADD MULTIPLICAND TQ PARTIAL PRODUCT 
MLP i: ADD HL, HL s;SHIFT PARTIAL PRODUCT 
DEC A 
UJIR NZ,MLP CONTINUE THROUGH 15 BITS 
300 LAST ADD IF MSB OF MULTIPLIER IS 1 
OR D sSIGN FLAG = MSB OF MULTIPLIER 
IP P,MLP2 
ADD HL, BC sADD IN MULTIPLICAND IF SIGN = 1 
sADD IN SECOND SUBSCRIPT 
MLP2: LD DE, (SS2) 
ADD HL, DE 
‘ADD BASE ADDRESS TO FORM FINAL ADDRESS 
POP DE ;GET BASE ADDRESS OF ARRAY 
ADD HL, DE s;ADD BASE TO INDEX 
sRETURN TO CALLER 
LD DE, (RETADR) sRESTORE RETURN ADDRESS TO STACK 
PUSH DE 
RET 


7 DATA 


204 array MANIPULATION 


RETADR: DS 
SS2s DS 


ws “ae ve “a US 


SCSCs 
LD 
PUSH 
LD 
PUSH 
LD 
PUSH 
LD 
PUSH 
CALL 


JR 


7 DATA 
SUBSi: DW 
SSUBS1: DW 
SUBS2: DW 


3 THE ARRAY (3 ROWS OF 8 COLUMNS) 


ARY: DR 
DB 
DB 


END 


SAMPLE EXECUTION: 


HL, ARY 

HL 

HL, (SUBS1) 
HL 

HL, (SSUBS1) 
HL 

HL, (SUBS2) 
HL 

D2BYTE 


scsc 


0 bh 


1 ,2,3 ,4 


7 TEMPORARY FOR RETURN ADDRESS 
3 TEMPORARY FOR SECOND SUBSCRIPT 


7;PUSH BASE ADDRESS OF ARRAY 
;PUSH FIRST SUBSCRIPT 

;PUSH SIZE OF FIRST SUBSCRIPT 
7;PUSH SECOND SUBSCRIPT 


7;CALCULATE ADDRESS 

7FOR THE INITIAL TEST DATA 

7HL = ADDRESS OF ARY(C2, 4) 

= ARY + (223) + 4 

= ARY + 20 (CONTENTS ARE 21) 
NOTE BOTH SUBSCRIPTS START AT O 


s 
r 
* 
r 
a 
r 


;SUBSCRIPT 1 
7SIZE OF SUBSCRIPT 1 
;SUBSCRIPT 2 


77 8 


9 ,10,11,12,13,14,15,16 
17,18,19, 20, 21, 22,23, 24 


“ea 


<a 


—ust “8 6SS 


Two-Dimensional Word Array 


Indexing (D2WOlD) 


Calculates the starting address of an element 
of a two-dimensional word-length (16-bit) array, 
given the base address of the array, the two 
subscripts of the element, and the size of a row in 
bytes. The array is assumed to be stored in row 
major order (that is, by rows) and both sub- 
scripts are assumed to begin at 0. 

Procedure: The program multiplies the row 
size (in bytes) times the row subscript (since the 
elements are stored by row), adds the product to 
the doubled column subscript (doubled because 
each element occupies two bytes), and adds the 
sum to the base address. The program uses a 


Entry Conditions 
Order in stack (starting at the top) 


Less significant byte of return address 
More significant byte of return address 


Less significant byte of column subscript 
More significant byte of column subscript 


Less significant byte of size of rows (in bytes) 
More significant byte of size of rows (in bytes) 


Less significant byte of row subscript 
More significant byte of row subscript 


Less significant byte of base address of array 
More significant byte of base address of array 


Examples 


1. Data: Base address = 5E14,, 

Column subscript = 0008 j¢ 

Size of a row (in bytes) = 001Cj¢ (i.e., each 
row has 0014) or OOOE,, word-length ele- 
ments) 


Row subscript = 00051¢ 


Result: 


OD 


Registers Used: AE BC, DE, HL 


Execution Time: Approximately 1100 cycles, de- 
pending mainly on how long it takes to multiply row 
size times row subscript 


Program Size: 45 bytes 


Data Memory Required: Four bytes anywhere in 
memory to hold the return address (two bytes start- 
ing at address RETADR) and the column subscript 
(two bytes starting at address SS2) 





standard shift-and-add algorithm (see Subrou- 
tine 6A) to multiply. 


Exit Conditions 


Starting address of element in HL 
The element occupies the address in HL and the 
next higher address 


Element starting address = 5E14,¢ + 0005,¢* 
001C 6 + 0008), * 2 = S5E14,¢ + 008Ci, + 
0010,, = SEBO), 

That is, the starting address of ARRAY(5,8) 
is SEBO,, and the element occupies SEBO ¢ 
and 5EB1¢ 
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2. Data: Base address = B100)j¢ 

Column subscript = 0002)¢ 

Size of a row (in bytes) = 0008j¢ (i.e., each 
row has four word-length elements) 


Row subscript = 0006), 


Result: Element starting address = B100)¢ + 0006)¢ * 
0008 1¢ = 000216 *2= B1004¢ i 0030 i6 ae 


0004. = B1341¢ 


That is, the starting address of ARRAY(6,2) 
is B134,¢ and the element occupies B134j¢ 
and B1354¢ 


The general formula is 


ELEMENT STARTING ADDRESS = ARRAY 
BASE ADDRESS + ROW SUBSCRIPT * 
SIZE OF ROW + COLUMN SUBSCRIPT * 2 


“we ws 48 WH NS 6S 


Title 
Name: D2WORD 
Purposes 

subscripts ’I’,’J7’, 

subscript in bytes, 

ACI, J. 

row major order (ACO,O], 

A: ARRAYCO..2,0..7] OF WORD: 

Entry: TOP OF STACK 


NOTE: 


wa “@ ve ve we ws NS 6S UMS le Me MSs MSH UNE SR UE wR UNS Me UME UNE eR ee Se 


Two-dimensional word array indexing 


Given the base address of a word array, 


The array is assumed to be stored in 


and both dimensions are assumed to begin at 
zero as in the following Pascal declaration: 


Low byte of return address, 

High byte of return address, 

Low byte of second subscript (column element) 

High byte of second subscript (column element) 
Low byte of first subscript size, 

High byte of first subscript size, 
Low byte of first subscript (row element), 

High byte of first subscript ‘Craw element), 
Law byte of array base address, 

High byte of array base address, 


The first subscript size is length of a raw 
in words *® 2 


Note that one parameter of this routine is the 
size of a row in bytes. The size for word-length 
elements is the number of columns per row 
times 2 (the size of an element in bytes). The 
reason we chose this parameter rather than the 
number of columns or the maximum column 
index is that this parameter can be calculated 
once (when the array bounds are determined) 
and used whenever the array is accessed. The 
alternative parameters (number of columns or 
maximum column index) would require extra 
calculations during each indexing operation. 


we se we “Ss “a VS WS Ne 


twa 
and the size of the first 
calculate the address of 


ACO,1],..., ALK,LI), 


“eo se va we w8 we NS NSH UME UME UNS UNS UE UR UNS NO 


in bytes, 
in bytes, 


wes 6©“~8 6w8 ws we Ne ES 
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Exits Register H = High byte af element address 
Register L = High byte of element address 


Registers used: AF,BC, DE, HL 


=—eaoue ve VSB WA WE 


“ee “8 “8 “8 “Ss “WS “SA WS VS WOH VS WS 


Time: Approximately 1100 cycles Hl 
Sizes Program 45 bytes . 
Data 4 bytes H 


D2WORD: 
7;SAVE RETURN ADDRESS 
POP HL 
LD CRETADR) , HL 
;GET SECOND SUBSCRIPT, MULTIPLY BY 2 FOR WORD-LENGTH ELEMENTS 
POP HL 
ADD HL, HL 7* 2 
LD (SS2),HL 
7;GET SIZE OF FIRST SUBSCRIPT (ROW LENGTH), FIRST SUBSCRIPT 
POP DE 7;GET LENGTH OF ROW 
POP BC ;GET FIRST SUBSCRIPT 
sMULTIPLY FIRST SUBSCRIPT # ROW LENGTH USING SHIFT AND ADD 
; ALGORITHM. PRODUCT IS IN HL 
LD HL, 0 ;PRODUCT = O 
LD A,15 ;COUNT = BIT LENGTH —- 1 
MLP: 
SLA E ;SHIFT LOW BYTE OF MULTIPLIER 
RL D sROTATE HIGH BYTE OF MULTIPLIER 
JR NC, MLP 1 ;JUMP IF MSB OF MULTIPLIER = 0 
ADD HL, BC sADD MULTIPLICAND TQ PARTIAL PRODUCT 
MLP1: ADD HL, HL ;SHIFT PARTIAL PRODUCT 
DEC A 
JR NZ,MLP 7CONTINUE THROUGH 15 BITS 
7ADD MULTIPLICAND IN LAST TIME IF MSB OF MULTIPLIER IS 1 
OR D 7SIGN FLAG = MSB OF MULTIPLIER 
JP P,MLP2 
ADD HL, BC 7,ADD IN MULTIPLICAND IF SIGN = 1 
7;ADD IN SECOND SUBSCRIPT 
MLP2: LD DE, (SS2) 
ADD HL, DE 
7;ADD BASE ADDRESS TQ FORM FINAL ADDRESS 
POP DE 7;GET BASE ADDRESS OF ARRAY 
ADD HL, DE 7;ADD BASE TO INDEX 
s;RETURN TO CALLER 
LD DE, CRETADR) ;RESTORE RETURN ADDRESS TQ STACK 
PUSH DE 


RET 
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7 DATA 


RETADR: DS 
$$23: Ds 


ws 6“8 6“ wR OMS 


SCS0: 
LD 
PUSH 
LD 
PUSH 
LD 
PUSH 
LD 
PUSH 
CALL 


JR 


7 DATA 
SUBS1i: DW 
SSUBS1: DW 
SUBS2: DW 


7 THE ARRAY (3 ROWS OF 


ARY: DW 
DW 
DW 


END 


SAMPLE EXECUTION: 


HL, ARY 

HL 

HL, (SUBS1) 

HL 

HL, (SSUBS1) 
HL 

HL, (SUBS2) 

HL 

D2WORD 


SsCSD 


2 
ié 
4 


8 COLUMNS) 


7 TEMPORARY FOR RETURN ADDRESS 
s TEMPORARY FOR SECOND SUBSCRIPT 


7PUSH BASE ADDRESS OF ARRAY 
;PUSH FIRST SUBSCRIPT 

s;PUSH SIZE OF FIRST SUBSCRIPT 
7;PUSH SECOND SUBSRIPT 


;CALCULATE ADDRESS 

7;FOR THE INITIAL TEST DATA 

7 HL ADDRESS OF ARY(2,4) 

; ARY + (2816) + 4 ® 2 

ARY + 40 (CONTENTS ARE 2100H) 
NOTE BOTH SUBSCRIPTS START AT O 


y 
s 
? 
s 
r 


7;SUBSCRIPT 1 
7;SIZE OF SUBSCRIPT 1 
7SUBSCRIPT 2 


0100H, 0200H, 0300H, 0400H, O500H, 0600H, 0700H, OS00H 
O700H, 1000H, 1100H, 1200H, 1300H, 1400H, 1500H, 1600H 
1700H, 1S00H, 1900H, 2000H, 2100H, 2200H, 2300H, 2400H 


“ws “we “8 SS OWS 


N-Dimensional Array 
Indexing (NDI) 


Calculates the starting address of an element 
of an N-dimensional array given the base address 
and N pairs of sizes and subscripts. The size of a 
dimension is the number of bytes from the start- 
ing address of an element to the starting address 
of the element with an index one larger in the 
dimension but the same in all other dimensions. 
The array is assumed to be stored in row major 
order (that is, organized so that subscripts to the 
right change before subscripts to the left). 

Note that the size of the rightmost subscript is 
simply the size of the elements (in bytes); the size 
of the next subscript is the size of the elements 
times the maximum value of the rightmost sub- 
script plus 1, and so forth. All subscripts are 
assumed to begin at 0. Otherwise, the user must 
normalize the subscripts. (See the second exam- 
ple at the end of the listing.) 

Procedure: The program loops on each dimen- 
sion, calculating the offset in that dimension as 
the subscript times the size. If the size is an easy 


Entry Conditions 
Order in stack (starting from the top) 


Less significant byte of return address 
More significant byte of return address 


Less significant byte of number of dimensions 
More significant byte of number of dimensions 
(not used) 


Less significant byte of size of rightmost dimen- 
sion 

More significant byte of size of rightmost dimen- 
sion 

Less significant byte of rightmost subscript 

More significant byte of rightmost subscript 


OE 


Registers Used: AF, BC, DE, HL 

Execution Time: Approximately 1300 cycles per 
dimension plus 165 cycles overhead (depending 
mainly on how much time is required to perform the 
multiplications) 


Program Size: 120 bytes 


Data Memory Required: Five bytes anywhere in 


memory to hold the return address (two bytes start- 
ing at address RETADR), the accumulated offset 
(two bytes starting at address OFFSET), and the 
number of dimensions (one byte at address 
NUMDIM) 


Special Case: If the number of dimensions is 0, the 
program returns with the base address in HL. 





case (an integral power of 2), the program reduc- 
es the multiplication to left shifts. Otherwise, it 
performs each multiplication using the shift- 
and-add algorithm of Subroutine 6A. Once the 
program has calculated the overall offset, it adds 
that offset to the base address to obtain the 
starting address of the element. 


Exit Conditions 


Starting address of element in HL 

The element occupies memory addresses START 
through START + SIZE — 1, where START 
is the calculated address and SIZE is the size 
of an element in bytes. 
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Less significant byte of size of leftmost dimen- 
sion 

More significant byte of size of leftmost dimen- 
sion 

Less significant byte of leftmost subscript 

More significant byte of leftmost subscript 


Less significant byte of base address of array 
More significant byte of base address of array 


Example 


1. Data: Base address = 3C00)¢ 

Number of dimensions = 0003 ,¢ 

Rightmost subscript = 0005), 

Rightmost size = 0003), (3-byte entries) 

Middle subscript = 0003) 

Middle size = 0012,¢ (six 3-byte entries) 

Leftmost subscript = 0004), 

Leftmost size = 007Ej;¢ (seven sets of six 3- 
byte entries) 


Element starting address = 3C00)¢ + 00054¢ * 
0003), + 0003,¢, * 0012), + 0004, * 
007E 16 = 3C00j¢ ais 000F i¢ + 0036 4¢ + 
O1F8 16 = 3E3Di¢ 

That is, the element is ARRAY(4,3,5); it 
occupies addresses 3E3D)¢ through 3E3F\¢ 
(the maximum values of the various sub- 
scripts are 6 (leftmost) and 5 (middle) with 
each element occupying three bytes) 


Result: 


The general formula is 

STARTING ADDRESS = BASE ADDRESS + 

N-l 

>, SUBSCRIPT, * SIZE, 

i=0 
where 

N is the number of dimensions 

SUBSCRIPT; is the ith subscript 

SIZE; is the size of the ith dimension 

Note that we use the size of each dimension as 
a parameter to reduce the number of repetitive 
multiplications and to generalize the procedure. 
The sizes can be calculated and saved as soonas 
the bounds of the array are known. Those sizes 
can then be used whenever indexing is per- 
formed on that array. Obviously, the sizes do not 
change if the bounds are fixed, and they should 
not be recalculated as part of each indexing 
operation. The sizes are also general, since the 
elements can themselves consist of any number 
of bytes. 


=e ~8s we ws wea “8 SE MS 


a) | ee |) ee ee ee) et ee ee | | 


“B we “8 we MS wR Ve UME UNS NSB SME UH NR NE MS ME UMAR UNS UMP lus NR ME ONS 


“as 06th NS NB UME UMA NR UNS ER 


Title 
Name: 


Furposes: 


Entrys 


Exits 


Registers used: 


Times 
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N-dimensional array indexing 
NDIM 


Calculate the address of an element in an 
N-dimensional array given the base address, 
N pairs of size in bytes and subscript, and the 
number of dimensions of the array. The array is 
assumed to be stored in raw major order 
(ACLO,0,0],AL0,0,1],...,A£0,1,0],A00,1,1],...). 
Also, it is assumed that all dimensions begin 
at 0 as in the following Pascal declaration: 

A: ARRAYCO..10,0..3,0..5] OF SOMETHING 
For arrays that do not begin at O boundaries, 
normalization must be performed before calling 
this routine. An example is given at the end. 


TOP OF STACK 
Low byte of return address, 
High byte of return address, 
Law byte of number dimensions, 
High byte of number dimensions (not used), 
Low byte of dim N-1 size 
High byte of dim N-1 size 
Low byte of dim N-1 subscript 
High byte of dim N-1 subscript 
Low byte af dim N-2 size 
High byte of dim N-2 size 
Low byte of dim N-2 subscript 
High byte of dim N-2 subscript 


Law byte of dim 0 size 

High byte of dim 0 size 

Low byte of dim 0 subscript 

High byte of dim O subscript 

Low byte of array base address 

High byte of array base address 
NOTE: 

All sizes are in bytes 


Register H = High byte of address 
Register L = Low byte of address 


AF,BC, DE, HL 


Approximately 1300 cycles per dimension 
Plus 165 cycles overhead 


“we =e “8 “8 “SB VS WE NS 
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=e “e@ ws UB OS 


NDIM: 


LOOP: 


ADBASE : 


Sizes: Program 120 bytes 
Data 3S bytes 


7;POP PARAMETERS 


POP HL. 

LO CRETADR) , HL 

sOQOFFSET := 0 

LD HL, 

LD (OFFSET),HL 

;GET NUMBER OF DIMENSIONS AND TEST FaR © 

POP HL 

LD A,L 

LO CNUMDIM),A sGET NUMBER GF DIMENSIONS 
OR A sTEST FOR 0 

UJIR Z, ADBASE ;RETURN WITH BASE ADDRESS IN HL 


; IF THERE ARE NO DIMENSIONS 


sLOQP ON EACH DIMENSION 
> DOING OFFSET := OFFSET + (SUBSCRIPT ® SIZE) 


POP DE 7;GET SIZE 

POP HL. 7;GET SUBSCRIPT 

CALL NX TOFF ;OFFSET := OFFSET + (SUBSCRIPT ® SIZE) 
LD HL, NUMDIM 

DEC CHL) 7;DECREMENT NUMBER OF DIMENSIONS 

IR NZ, LOOP 7CONTINUE THROUGH ALL DIMENSIONS 


s;CALCULATE STARTING ADDRESS OF ELEMENT 
;OFFSET = BASE + OFFSET 


LD HL, (OFFSET) 

POP DE ;GET BASE ADDRESS 
ADD HL, DE 7SUM WITH OFFSET 
7RESTORE RETURN ADDRESS AND EXIT 

LD DE, (RETADR) 

PUSH DE 

RET 


7; SUBROUTINE NXTOFF 
;PURPOSE: OFFSET := OFFSET + (SUBSCRIPT ® SIZE); 
7;ENTRY: OFFSET = CURRENT OFFSET 

DE = CURRENT SIZE OF THIS DIMEMSION 

HL = CURRENT SUBSCRIPT 
XIT: OQFFSET = OFFSET + (SUBSCRIPT + SIZE); 
EGISTERS USED: AF, BC, DE, HL 


s 
v 
a 
? 
s 
? 
s 
? 


A) mm 


a | ee eT | 


ve 


NXTOFF : 


EASYLP: 


SHIFT: 


BIGSZ: 


MLP: 


MLP IL: 
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PUSH HL ;SAVE CURRENT SUBSCRIPT IN STACK 
sCHECK IF SIZE IS POWER OF 2 LESS THAN 2564 

LD A,D 

OR A 7;HIGH BYTE = O 7? 

JR NZ, BIGSZ ;JUMP IF SIZE IS LARGE 

LD A,E 7A = LOW BYTE OF SIZE 

LD HL, EASYAY 7HL = BASE ADDRESS OF EASYAY 

LD B, SZEASY 7B = SIZE OF EASY ARRAY 

LD c,0 7;C = SHIFT COUNTER 

CP CHL) 

JR Z, ISEASY ;JUMP IF SIZE IS A POWER OF 2 
INC HL 7 INCREMENT TQ NEXT BYTE OF EASYAY 
INC C s INCREMENT SHIFT CQUNTER 

DJNZ EASYLP ;DECREMENT COUNT 

JR BIGSZ 7;JUMP IF SIZE IS NOT EASY 

POP HL ;GET SUBSCRIPT 

LD A,C GET NUMBER OF SHIFTS 

OR A 7TEST FOR O 

JR Z, ADDOFF 7;JUMP IF SHIFT FACTOR = 0 


7;ELEMENT SIZE ® SUBSCRIPT REDUCES TO LEFT SHIFTS 


LD B,A 7B = SHIFT COUNT 

ADD HL, HL MULTIPLY SUBSCRIPT BY 2 

DJINZ SHIFT s;CONTINUE UNTIL DONE 

JR ADDOFF ;DOQNE SO ADD OFFSET + SUBSCRIPT 


7;SIZE IS NOT POWER OF 


MULTIPLY 


; ELEMENT SIZE TIMES SUBSCRIPT THE HARD WAY 


POP 


BC 


7;GET SUBSCRIPT 


;MULTIPLY FIRST SUBSCRIPT = ROW LENGTH USING SHIFT AND ADD 


; ALGORITHM. RESULT IS IN HL 

; BC = SUBSCRIPT (MULTIPLICAND) 

; DE = SIZE (MULTIPLIER) 

LD HL, 0 ;PRODUCT = 0 

LD A,15 ;CQOUNT = BIT LENGTH - 1 

SLA E ;SHIFT LOW BYTE OF MULTIPLIER 
RL D 7;ROTATE HIGH BYTE OF MULTIPLIER 
JR NC,MLP1 7;JUMP IF MSB OF MULTIPLIER = 0 
ADD HL, BC 7;ADD MULTIPLICAND TO PARTIAL PRODUCT 
ADD HL, HL ;SHIFT PARTIAL PRODUCT 

DEC A 

JR NZ,MLP ?CONTINUE THROUGH 15 BITS 


s;ADD IN MULTIPLICAND LAST TIME IF MSB OF MULTIPLIER IS 1 
OR D 7;SIGN FLAG = MSB OF MULTIPLIER 
IP P, ADDOFF 
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ADDOFF : 


EASYAY: 


SZEASY 


RETADR: 
OFFSET: 
NUMDIM: 


“ua we “8B MS NO 


SCSE: 


ADD HL, BC sADD IN MULTIPLICAND IF SIGN = 1 
‘sADD SUBSCRIPT ® SIZE TQ OFFSET 
EX DE, HL 
LD HL, (OFFSET) sGET OFFSET 
ADD HL, DE :ADD PRODUCT OF SUBSCRIPT * SIZE 
Lo (OFFSET), HL >SAVE OFFSET 
RET 
:SHIFT FACTOR 
DB i 20 
DR 2 s1 
DB 4 sa 
DB 8 23 
DB 16 24 
DR 32 75 
DB 64 36 
DB 128 37 
EQU $-EASYAY 
> DATA 
ns 2 > TEMPORARY FOR RETURN ADDRESS 
nS 2 > TEMPORARY FOR PARTIAL OFFSET 
ps 1 sNUMBER OF DIMENSIONS | 


SAMPLE EXECUTION: 


7;FIND ADDRESS OF AY101,3,0] 
; SINCE LOWER BOUNDS OF ARRAY 1 ARE ALL ZERO IT IS NOT 
; NECESSARY TO NORMALIZE THEM 


;PUSH BASE ADDRESS OF ARRAY 1 


LD HL, AY1 

PUSH HL 

;PUSH SUBSCRIPT/SIZE FOR DIMENSION 1 
LD HL, 1 

PUSH HL ; SUBSCRIPT 
LD HL, A1SZ1 

PUSH HL ;SIZE 

PUSH SUBSCRIPT/SIZE FOR DIMENSION 2 
LD HL, 3 

PUSH HL ; SUBSCRIPT 
LD HL, A1SZ2 

PUSH HL ;SIZE 


;PUSH SUBSCRIPT/SIZE FOR DIMENSION 3 
LD HL, 9 


“we we uS Se WE 
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PUSH HL. ; SUBSCRIPT 

LD HL,A1SZ3 

PUSH HL 7SIZE 

;PUSH NUMBER OF DIMENSIONS 

LD HL,ALDIM 

PUSH HL 

CALL NDIM ;CALCULATE ADDRESS 


7 AY STARTING ADDRESS OF ARY1(1,3,0) 
ARY + (18126) + (3821) + (O#G) 


ARY + 189 


~<a “8 


;CALCULATE ADDRESS OF AY2E-1,6] 
; SINCE LOWER BOUNDS OF AY2 DO NOT START AT O, SUBSCRIPTS 
; MUST BE NORMALIZED 


;PUSH BASE ADDRESS OF ARRAY 2 


LD HL, AY2 
PUSH HL 
s;PUSH CSUBSCRIPT — LOWER BOUND) /SIZE FOR DIMENSION 1 
LO HL, -1 
LD DE, ~A2DiL sNEGATIVE QF LOWER BOUND 
ADD HL, DE s;ADD NEGATIVE TO NORMALIZE Ta oO 
PUSH HL s SUBSCRIPT 
LD HL, A2SZ1 
PUSH HL. s;SIZE 
;PUSH CSUBSCRIPT - LOWER BOUND) /SIZE FOR DIMENSION 2 
LD HL, 6 
LD DE, -A2D2L s;NEGATIVE OF LOWER BOUND 
ADD HL, DE s;ADD NEGATIVE TO NORMALIZE TO 0 
PUSH HL ; SUBSCRIPT 
LD HL, A2SZ2 
PUSH HL sSIZE 
;PUSH NUMBER OF DIMENSIONS 
LD HL, A2DIM 
PUSH HL. 
CALL NDIM sCALCULATE ADDRESS 
sAY=STARTING ADDRESS QF ARY1(-1,6) 
—  S=ARY+0(00-1)-0-35))#18)4¢(6-2)22) 
; =ARY + 80 
JR SCSE 
7 DATA | 
7AY1 =: ARRAYCAIDIL. .AIDIH, AL1D2L..A1D2H, ALDSL..A1D3H] 3-BYTE ELEMENTS 
; C O «es» 3 » OQ «2 BS » O ae & JY 
A1LDIM EQU 3 NUMBER OF DIMENSIONS 
ALDIL EQU 0 s;LOW BOUND OF DIMENSION 1 
A1LDIH EQU 3 HIGH BOUND OF DIMENSION 1 
A1D2L EQU 0 7;LOW BOUND OF DIMENSION 2 
A1D2H EQU rat HIGH BOUND OF DIMENSION 2 
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ALID3L 
A1D3H 
A1SZ3 
A1SZ2 
A1SZ1 
AY1: 


7 AY2 


A2DIM 
AZDIL 
AZD1H 
A2ZD2L 
A2D2H 
A2SZ2 
A2SZ1 
AY2: 


EQU 
EQU 
EQU 
EQU 
EQU 
DS 


EQU 
EQU 
EQU 
EQU 


c 


0 
é 
3 
(CALDSH-ALDSL +19 8AISZ3 
(CA1LD2H-A1LD2L)+1)#A1SZ2 
(CAIDIH-AIDILI+1)#A1SZ1 


ARRAYCAIDIL. .AIDIH, A1D2L..ALD2HI 
-S ee -1 ? 2 ee 10 J 
2 
=—3 
-1 
2 
10 


EQu 
EQU 
EQu 
DS 


END 


ya 


( CA2D2H-A2D2L )+1)#A25Z2 
(CA2D1LH-A2ZD1ILI+1)#A25Z1 


;LOW BOUND OF DIMENSION 3 
sHIGH BOUND OF DIMENSION 3 
;SIZE OF ELEMENT IN DIMENSION 
;SIZE OF ELEMENT IN DIMENSION 
s;SIZE OF ELEMENT IN DIMENSION 
7 ARRAY 


OF WORD 


;NUMBER OF DIMENSIONS 

7;LOW BOUND OF DIMENSION 1 
;HIGH BOUND OF DIMENSION 1. 
7LOW BOUND OF DIMENSION 2 
7;HIGH BOUND OF DIMENSION 2 
7;SIZE OF ELEMENT IN DIMENSION 
;SIZE OF ELEMENT IN DIMENSION 
+ ARRAY 


em ho 0) 


mm RO 


16-Bit Multiplication (\MUL16) 


Muttiplies two 16-bit operands and returns 
the less significant (16-bit) word of the product. 

Procedure: The program uses an ordinary 
shift-and-add algorithm, adding the multipli- 
cand to the partial product each time it finds a 1 
bit inthe multiplier. The partial product and the 
multiplier are shifted left 15 times (the number 
of bits in the multiplier minus 1) to produce 
proper alignment. The more significant 16 bits 
of the product are lost. 


Entry Conditions 


Multiplicand in HL 
Multiplier in DE 


Examples 


1. Data: Multiplier = 0012;¢ 


Multiplicand = 03D14¢ 
Product = 44B24¢ 
The more significant word is 0. 


Result: 


Note that MUL16 returns only the less signif- 
icant word of the product to maintain compati- 


6A 


Registers Used: AF, BC, DE, HL 


Execution Time: Approximately 865 to 965 cycles, 
depending largely on the number of | bits in the 


multiplier 
Program Size: 22 bytes 
Data Memory Required: None 





Exit Conditions 


Less significant word of product in HL 


2. Data: Multiplier = 37D 1 j¢ 
Multiplicand = A0451¢ 
Result: Product = ABS55i¢ 


This is actually the less significant 16-bit word 
of the 32-bit product 22F1AB55,¢. 


bility with other 16-bit arithmetic operations. 
The more significant word of the product is lost. 





Title 


Name: MUL14 


“us =e 46 VS 3S BH NH OMS 


Purpose: 


=F NH US 


14-bit Multiplicatian 


Multiply 2 signed or unsigned 16-bit wards and 
return a 16-bit signed or unsigned product 


“ss =s wh © WE “EH VA HS 


“ue “8 = 


217 
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usp “8S “SF “NS DE NH HSH US SE ONS SS HH UHH UMS UNS NH MH NH UE OOS 


MULIG: 


MLFs: - 


MLP1: 


use 6“=6 © MSE MSE 


Answers needing more than 14 bits: bits higher 
than bit 15 are lost 


Entry: Register L = Law byte of multiplicand 
Register H = High byte of multiplicand 
Register E = Low byte of multiplier 
Register D = High byte of multiplier 

Exits Fraduct = multiplicand * multiplier 


Register L = Law byte of product 
Register H = High byte af praduct 


Registers used: AF,BC, DE, HL 
Time: Approximately 8645 to 965 cycles 


Sizes: Program 22 bytes 


INITIALIZE PARTIAL PRODUCT, BIT COUNT 


LD C,t ;BC = MULTIPLIER 

LD B,H 

LD HL, 0 ;PRODUCT = 0 

LD A,15 ;CQUNT = BIT LENGTH - 1 


7SHIFT-AND-ADD ALGORITHM 

; IF MSB OF MULTIPLIER IS 1, ADD MULTIPLICAND TQ PARTIAL 
; PRODUCT 

: SHIFT PARTIAL PRODUCT, MULTIPLIER LEFT 1 BIT 


SLA E ;SHIFT MULTIPLIER LEFT 1 BIT 

oR NC, MLPL ;JUMP IF MSB OF MULTIPLIER = 0 

ADD HL, BC 7ADD MULTIPLICAND TQ PARTIAL PRODUCT 
ADD HL, HL 7;SHIFT PARTIAL PRODUCT LEFT 

= NZ, HEP s;CONTINUE UNTIL COUNT = 0 


sADD MULTIPLICAND ONE LAST TIME IF MSB OF MULTIPLIER IS 1 


OR BD 7SIGN FLAG = MSB OF MULTIPLIER 
RET P 7;EXIT IF MSB OF MULTIPLIER IS O 
ADD HL, BC 7ADD MULTIPLICAND TO PRODUCT 
RET 


SAMPLE EXECUTION: 


“=e 


—s =f “SB “S “SF “EF VHA ~S WH HEHE WH UH MH SH UE MH UH UR HS 


ue =e wH 6S OB 


SCéA:? 


LD 
LD 
CALL 


JR 


END 


HL, -—2 
DE, 1023 
MUL1I6 


SCéA 
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7HL = MULTIPLICAND 

7;DE = MULTIPLIER 

316-BIT MULTIPLY 

7;RESULT OF 1023 ® -2 = -2046 = OFSO2H 
; REGISTER L = O2H 

? H = FSH 


16-Bit Division (SDIV16, UDIV16) 


Divides two 16-bit operands and returns the 
quotient and the remainder. There are two entry 
points: SDIV16 divides two 16-bit signed oper- 
ands, whereas UDIV16 divides two 16-bit un- 
signed operands. If the divisor is 0, the Carry 
flag is set to 1 and both quotient and remainder 
are set to 0; otherwise, the Carry flag 1s cleared. 

Procedure: If the operands are signed, the 
program determines the sign of the quotient and 
takes the absolute values of any negative oper- 
ands. It must also retain the sign of the dividend, 
since that determines the sign of the remainder. 
The program then performs an unsigned division 
using a shift-and-subtract algorithm. It shifts 
the quotient and dividend left, placing a | bit in 
the quotient each time a trial subtraction is 
successful. If the operands are signed, the program 
must negate (that is, subtract from 0) the 
quotient or remainder if either is negative. The 


Entry Conditions 


Dividend in HL 
Divisor in DE 


Examples 


1. Data: Dividend = 03E0j¢ 


Divisor = 00B6j¢ 

Quotient (from UDIV16) = 0005,, 
Remainder (from UDIV16) = 0052. 
Carry = 0 (no divide-by-0 error) 


Result: 
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Registers Used: AF, BC, DE, HL 


Execution Time: Approximately 1770 to 2340 cycles, 
depending largely on how many trial subtractions are 
successful and thus require the replacement of the 
previous dividend by the remainder 


Program Size: 104 bytes 


Data Memory Required: 3 bytes anywhere in 
RAM for the sign of the quotient (address SQUOT), 
the sign of the remainder (address SREM), and a 
divide loop counter (address COUNT) 


Special Case: If the divisor is 0, the program 
returns with the Carry set to 1, and both the quotient 
and the remainder set to 0. 





Carry flag is cleared if the division is proper and 
set if the divisor is 0. A 0 divisor also causes a 
return with the quotient and remainder both set 
to 0. 


Exif Conditions 


Quotient in HL 

Remainder in DE 

If the divisor is non-zero, Carry = 0 and the 
result is normal. 

If the divisor is 0, Carry = 1 and both quotient 
and remainder are 0000. 


2. Data: Dividend = D73A\j¢ 
Divisor = 02F 1 4¢ 
Result: Quotient (from SDIV16) = FFF3)¢ 


Remainder (from SDIV16) = FD77\¢ 
Carry = 0 (no divide-by-0 error) 
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The remainder of a signed division may be _ 1 from the quotient and add the divisor to the 
either positive or negative. Inthis procedure,the remainder. The result of Example 2 is then 
remainder always takes the sign of the dividend. Quotient = FFF2,, = — 1419 
A negative remainder can easily be converted Remainder (always positive) = 0068, 
into one that is always positive. Simply subtract 


“=e “8 “SG VSB “SB VB WE US 
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Title 16-bit Division 
Name: SDIVié, UDIV1L46 
Purpose: SDIV16 


Divide 2 signed 16-bit words and return a 
16-bit signed quotient and remainder 


UDIV16 
Divide 2 unsigned 14-bit words and return a 
16-bit unsigned quotient and remainder 


ea 6“e@ “a “4 ~R VR we WER VA we MVE VHA UH UR UR UHR UNH wR 


Entry: Register L = Low byte of dividend 
Register H = High byte of dividend 
Register E = Low byte of divisor 
Register D = High byte of divisor 

Exits Register L = Low byte of quotient 
Register H = High byte of quotient 
Register E = Low byte of remainder 
Register DTD = High byte of remainder 


If no errors then 
carry := 0 

else 
divide-by-zera error 
carry := 1 
quotient := 0 


remainder := 0 
Registers used: AF,BC,DE,HL 
Time: Approximately 1770 to 2340 cycles 
Sizes Program 105 bytes 


Data 3 bytes 


bt I i | ad a de ee i eT -2 ) ]  )  ) |) ey 2) 2) en Y 2) en | 
Oy ee ee | YY 
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SDIV16: 


CHKDE : 


DODIV: 


DOREM: 


7;SIGNED DIVISION 


;DETERMINE SIGN OF QUOTIENT BY EXCLUSIVE GORING HIGH BYTES 
QF DIVIDEND AND DIVISOR. QUQTIENT IS POSITIVE IF SIGNS 
ARE THE SAME, NEGATIVE IF SIGNS ARE DIFFERENT 


“=e “8 =e 


;REMAINDER HAS SAME SIGN AS DIVIDEND 


LD A,H 7;GET HIGH BYTE OF DIVIDEND 

LD CSREM),A 7;SAVE AS SIGN OF REMAINDER 

XOR D sEXCLUSIVE OR WITH HIGH BYTE OF DIVISOR 
LD CSQUOT),A 7;SAVE SIGN OF QUOTIENT 


;TAKE ABSOLUTE VALUE OF DIVISOR 


LD 4,0 

OR A 

JF P, CHKDE 7;JUMP IF DIVISOR IS POSITIVE 

SUB A ;SUBTRACT DIVISOR FROM ZERO 

SUB E 

LD E,A 

SBC A,A 7;PROPAGATE BORROW (CA=FF IF BORROW) 
SUB D 

LD D,A 


7;TAKE ABSOLUTE VALUE OF DIVIDEND 


LD 4,H 

QR AY 

JP P,DODIV 7;JUMP IF DIVIDEND IS POSITIVE 

SUB A ;SUBTRACT DIVIDEND FROM ZERO 

SUB L 

LD LA 

SBC A,A 7;PROPAGATE BORROW (CA=FF IF BORROW) 
SUB H 

LD H,A 


7DIVIDE ABSOLUTE VALUES 


CALL UDIV16é 


RET Cc 7;EXIT IF DIVIDE BY ZERO 
;NEGATE QUOTIENT IF IT IS NEGATIVE 

LD A, CSQUOT > 

OR A 

JP P, DOREM 7JUMP IF QUOTIENT IS POSITIVE 
SUB A ;SUBTRACT QUOTIENT FROM ZERO 
SUB L 

LD L,A 

SBC A,A ;PROPAGATE BORROW (CA=FF IF BORROW) 
SUB H 

LO H,A 


NEGATE REMAINDER IF IT IS NEGATIVE 
LD A, (SREM) 
OR A 


UNIVIiG: 


DIVIDE: 


DVLOOP ; 
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RET P ;RETURN IF REMAINDER IS POSITIVE 
SUB A ;SUBTRACT REMAINDER FROM ZERO 

SUB E 

LO E,A 

SBC A,A ;PROPAGATE BORROW (CA=FF IF BORROW) 
SUB D 

LD D,A 

RET 


FUNSTGNED DIVISION 


sCHECK FOR DIVISION BY ZERO 

LOD A,E 

OR D 

JR NZ, DIVIDE 7; BRANCH IF DIVISOR IS NON-ZERO 

LD HL, 9O ;DIVIDE BY O ERROR 

LD D,H 

LD E,t 

SCF 7SET CARRY, INVALID RESULT 

RET 

LD C,b 7C = LOW BYTE OF DIVIDEND/QUQTIENT 
LO A,H 7A = HIGH BYTE OF DIVIDEND/QUOTIENT 
LD HL, 0 7;HL = REMAINDER 

LD B,16 716 BITS IN DIVIDEND 

OR A 7;CLEAR CARRY TQ START 


IFT NEXT BIT OF QUOTIENT INTO BIT O QF DIVIDEND 
IFT NEXT MOST SIGNIFICANT BIT OF DIVIDEND INTO 

LEAST SIGNIFICANT BIT OF REMAINDER 
BRC HOLDS BOTH DIVIDEND AND QUOTIENT. WHILE WE SHIFT A 
BIT FROM MSB OF DIVIDEND, WE SHIFT NEXT BIT OF QUOTIENT 
IN FROM CARRY 
;HL HOLDS REMAINDER 


iS) 3 
a age 
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7DQ A 32-BIT LEFT SHIFT, SHIFTING 
7; CARRY TO C, C TQ A, A TOL, L TQ H 


RL. C 7CARRY (NEXT BIT OF QUOTIENT) TO BIT O, 
RLA ? SHIFT REMAINING BYTES 

RL L 

RL H 7;CLEARS CARRY SINCE HL WAS O 


7IF REMAINDER IS GREATER THAN OR EQUAL TO DIVISOR, NEXT 
; BIT OF QUOTIENT IS 1. THIS BIT GOES TO CARRY 


PUSH HL. 7SAVE CURRENT REMAINDER 
SRBC HL, DE 7;SUBTRACT DIVISOR FROM REMAINDER 
CCF 7COMPLEMENT BORROW SO 1 INDICATES 


>; A SUCCESSFUL SUBTRACTION 

; (THIS IS NEXT BIT OF QUOTIENT) 
IR C, DROP 7;JUMP IF REMAINDER IS >= DIVIDEND 
EX CSP),HL s;OTHERWISE RESTORE REMAINDER 
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DROP : 
INC SP sDROP REMAINDER FROM TOP OF STACK 
INC SP 
DUNZ DNVLOOP sCONTINUE UNTIL ALL BITS DONE 
*SHIFT LAST CARRY BIT INTOQ QUOTIENT 
EX DE, HL *DE = REMAINDER 
RL Cc sCARRY TA C 
LD L,Cc sL = LOW BYTE OF QUOTIENT 
RLA 
LD H,A °H = HIGH BYTE OF QUOTIENT 
QR A sCLEAR CARRY, VALID RESULT 
RET 
s DATA 

SQUQT: Os i sSIGN OF QUOTIENT 

SREM: Ds 1 sSIGN OF REMAINDER 

COUNT: OS 1 sDIVIDE LOOP COUNTER 


SAMPLE EXECUTION: 


=e “=e “SB NR MO 


A 
fe 
o 
2 


I 

HL = DIVIDEND 

DE = DIVISOR 
QUOTIENT OF -1023 / 123 = -$ 
= FSH 


LD HL, ~1023 
LD DE, 123 
CALL SDIVis 


REMAINDER OF -1023 / 123 = -39 
= DH 
= FFH 


“us “ws “Ss ~SB VS SSB WH SS ONS 


SIGNED DIVISION 
LD HL, 64513 L. = DIVIDEND 
LD DE, 123 E 
Q 


CALL UDTV1ié6é 


= DIVISOR 

TIENT OF 64513 / 123 = 324 
OCH 

O2H 

INDER OF 64513 / 123 = 41 
SDH 

OOH 


ws “ws ws “G8 wS SS NR NS NS 


A) 
Sane 
Hipri- 


JR SCéB 
END 


~~we ~a “EG SE WO 


16-Bit Comparison (CIVP16) 


Compares two 16-bit operands and sets the 
flags accordingly. The Zero flag always indicates 
whether the numbers are equal. If the operands 
are unsigned, the Carry flag indicates which is 
larger (Carry = | if subtrahend is larger and 0 
otherwise). If the operands are signed, the Sign 
flag indicates which is larger (Sign= | if subtra- 
hend is larger and 0 otherwise); two’s comple- 
ment overflow is considered and the Sign flag is 
inverted if it occurs. 

Procedure: The program subtracts the subtra- 
hend from the minuend. If two’s complement 
overflow occurs (Parity/ Overflow flag= 1), the 
program inverts the Sign flag by EXCLUSIVE 
ORing the sign bit with |. This requires an extra 
right shift to retain the Carry in bit 7 initially, 
since XOR always clears Carry. The program 
then sets Carry to ensure a non-zero result and 
shifts the data back to the left. The extra left 


Entry Conditions 


Minuend in HL 
Subtrahend in DE 


OC 


Registers Used: AF, HL 


Execution Time: 30 cycles if no overflow, 57 cycles 
if overflow 


Program Size: 11 bytes 
Data Memory Required: None 





shift uses ADC A,A rather than RLA to set the 
Sign and Zero flags (RLA would affect only 
Carry). Bit 0 of the accumulator must be | after 
the shift (because the Carry was set), thus 
ensuring that the Zero flag is cleared. Obviously, 
the result cannot be 0 if the subtraction causes 
two’s complement overflow. Note that after an 
addition or subtraction, PE (Parity/ Overflow 
flag = 1) means “overflow set” while PO 
(Parity/Overflow flag = 0) means “overflow 
clear.” 


Exit Conditions 


Flags set as if subtrahend had been subtracted 
from minuend, with a correction if two’s comple- 
ment overflow occurred. 


Zero flag= | if the subtrahend and minuend are 
equal; 0 if they are not equal. 


Carry flag = 1 if subtrahend is larger than 
minuend in the unsigned sense; 0 if it is less than 
or equal to the minuend. 


Sign flag = 1 if subtrahend is larger than 
minuend in the signed sense; 0 if it is less than or 
equal to the minuend. This flag is corrected 
(inverted) if two’s complement overflow occurs. 
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Examples 
1. Data: Minuend (HL) = 03E1i¢ 
Subtrahend (DE) = 07E4i¢ 
Result: Carry = 1, indicating subtrahend is larger in 
unsigned sense. 
Zero = 0, indicating operands are not equal. 
Sign = 1, indicating subtrahend is larger in 
signed sense. 
2. Data: Minuend (HL)= C51Aj¢ 
Subtrahend (DE) = C51Aj¢ 
Result: | Carry= 0, indicating subtrahend is not larger 


=e “se 4S SH NR NE UE NE 
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in unsigned sense. 
Zero = |, indicating operands are equal. 
Sign = 0, indicating subtrahend is not larger 
in signed sense. 


Title 16-bit Compare 
Name: CMP 16 
Purposes Compare 2 16-bit signed or unsigned words and 


return the C, 


Entry: Register L = Low byte of minuend 
Register H = High byte of minuend 
Register E = Law byte of subtrahend 
Register D = High byte of subtrahend 
Exits Flags returned based on minuend —- subtrahend 


If both the minuend and subtrahend are 2s 


camp lement 

flags; 
Else use the 
IF minuend = 


Z=1,S5=0,C= 
IF minuend > subtrahend THEN 
Z=0, S=0,C=0 
IF minuend < subtrahend THEN 
Z=0,S5=1,C=1 


Registers used: AF,HL 


Time: 30 cycles if 


3. Data: Minuend (HL) = A45Dj¢ 
Subtrahend (DE) = 77Eli¢ 


Result: | Carry= 0, indicating subtrahend is not larger 
in unsigned sense. 
Zero = 0, indicating operands are not equal. 
Sign = I, indicating subtrahend is larger in 
signed sense. 


In Example 3, the minuend is a negative two’s 
complement number, whereas the subtrahend is 
a positive two’s complement number. Subtract- 
ing produces a positive result (3C7Cj6) with 
two’s complement overflow. 


~e “8 ve wea we we we we 


Z,S flags set or cleared 


numbers, then use the Z and $ 


bt i) i, i | i) tt ee 


Z and C flags 
subtrahend THEN 
0 


use 6u8 6 68 


“ve wa 


=e 6“8 ~S “ER 


no overflow, else 57 cycles 
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. Size: Program 11 bytes . 
CMP16: 

OR A sCLEAR CARRY 

SBC HL, DE 3; SUBTRACT SUBTRAHEND FROM MINUEND 

RET PO sRETURN IF NO OVERFLOW 

LD A,H sQVERFLOW —- INVERT SIGN FLAG 

RRA > SAVE CARRY IN BIT 7 

XOR 01000000B sCQMPLEMENT BIT 6 CSIGN BIT) 

SCF sENSURE A NON-ZERO RESULT 

ADC A,A ;RESTORE CARRY, COMPLEMENTED SIGN 

> ZERQ FLAG = O FOR SURE 

RET 
; SAMPLE EXECUTION: . 
SCéC: 


COMPARE -32768 (8000 HEX) AND 1 
7SINCE -32768 IS THE MOST NEGATIVE 16-BIT NUMBER, 
; THIS COMPARISON WILL SURELY CAUSE OVERFLOW 


LD HL, -32762 

LD DE, 1 

CALL CMP 16 sCY = 0, Z=0, S= 1 
COMPARE -4 (FFFC HEX) AND -1 (FFFF HEX) 

CALL  CMP16 ;CY =1,Z2=0,$=1 
sCOMPARE -1234 AND -1234 

LD HL, -1234 

LD DE, ~1234 

CALL CMP 16 sCY = 0, Z=i1, S$ =9 
JR S$C6C 


Multiple-Precision Binary Addition 
(MPBADD) 6D 


Adds two multi-byte unsigned binary num- 
bers. Both numbers are stored with their least 


Registers Used: AF B, DE, HL 
Execution Time: 46 cycles per byte plus 18 cycles 


significant bytes at the lowest address. The sum overhead 
replaces the addend. The length of the numbers Program Size: 11 bytes 
(in bytes) is 255 or less. Data Memory Required: None 
Procedure: The program clears the Carry flag Special Case: A length of 0 causes an immediate 
initially and adds the operands one byte at a eins the addend unchanged. The Carry flag is 





time, starting with the least significant bytes. 
The final Carry flag reflects the addition of the 
most significant bytes. A length of 00 causes an 
immediate exit with no addition. 


Entry Conditions Exit Conditions 


Base address of addend in HL Addend replaced by addend plus adder 
Base address of adder in DE 
Length of the operands in bytes in B 


Example 


1. Data: Length of operands (in bytes) = 6 
Addend = 19D028A193EAj¢ 
Adder = 293EABF059C71)¢ 


Result: © Addend = 430ED491EDB1)¢ 


Carry = 0 
. Title Multiple-Precision Binary Addition : 
; Name: MPBADD . 
: Purpose: Add 2 arrays of binary bytes 


~“~se =e ‘“e 


Arrayl = Array! + Array2 
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Entry: Register pair HL = Base address of array i 
Register pair DE = Base address of array 2 
Register B = Length of the arrays 


The arrays are unsigned binary numbers with a 
maximum length of 2535 bytes, ARRAYCO] is the 
least significant byte, and ARRAYCLENGTH-1] 
the most significant byte. 


ea o6ue NS NB NS NE Ne UB UNE ONE 


Exits: Arrayl := Arrayl + Array2 
Registers used: AF,B, DE, HL 
Times 46 cycles per byte plus 18 cycles overhead 


Size: Program 11 bytes 


=e “es “we “S “A “8 “VS wR we ws BVH WS VS “WH YA vA WA NR Ne 
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MPBADD: 
sCLEAR CARRY, EXIT IF ARRAY LENGTH IS 0 
LD A,B 
AND A *CLEAR CARRY, TEST ACCUMULATOR 
RET Z RETURN IF LENGTH = ZERO 
LOOP: 
LO A, (DE) sGET NEXT BYTE 
Anc A, CHL) s;ADD BYTES 
LD CHL),A :STQRE SLIM 
INC HL s INCREMENT ARRAY! POINTER 
INC DE s INCREMENT ARRAY2 POINTER 
DUNZ LOOF sCONTINUE UNTIL COUNTER = 0 
RET 
: SAMPLE EXECUTION: ? 
SscéD: 
LD HL, AY 1 sHL = BASE ADDRESS OF ARRAY 1 
LD nE, AY2 7DE = BASE ADDRESS QF ARRAY 2 
Lo B,SZAYS sB = LENGTH OF ARRAYS IN BYTES 
CALL MPBADD s;ADD THE ARRAYS 
; AY1+0 = S6H 
; AYi+1 = 13H 
; AY1i+2 = CFH 
; AY1+3 = SAH 
; AY1+4 = 67H 
; AY14+5 = 45H 
; AY1+6 = 23H 
; AY1+7 = O1H 
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SZAYS 
AY1: 


ARITHMETIC 


JR 
EFQU 


DB 
DB 
DB 
DB 
DB 
DB 
DB 
DEB 


DB 
DB 
DB 
DB 
DB 
DB 
DE 
DE 


END 


7;LENGTH OF ARRAYS IN BYTES 


Multiple-Precision Binary Subtraction 
(MPBSUB) OE 


Subtracts two multi-byte unsigned binary Registers Used: AF, B, DE. HL 
numbers. Both numbers are stored with their Execution Time: 46 cycles per byte plus 22 cycles 
least significant bytes at the lowest address. The overhead 
difference replaces the minuend. The length of Program Size: 12 bytes 
the numbers (in bytes) is 255 or less. Data Memory Required: None 


Procedure: The program clears the Carry flag Special Case: A length of 0 causes an immediate 
initially and subtracts the operands one byte ata exit with the minuend unchanged (that is, the 
: : : — difference is equal to the minuend). The Carry flag is 
time, starting with the least significant bytes. Aeaeed. 
The final Carry flag reflects the subtraction of 
the most significant bytes. A length of 0 causes 
an immediate exit with no subtraction. 





Entry Conditions Exit Conditions 


Base address of minuend in HL Minuend replaced by minuend minus subtrahend 
Base address of subtrahend in DE 
Length of the operands in bytes in B 


Example 


1. Data: Length of operands (in bytes) = 4 
Minuend = 2F5BA7C3j¢ 
Subtrahend = 14DF35B8j¢ 
Result: © Minuend = 1A7C720Bi¢ 
The Carry flag is set to 0 since no borrow is 


necessary. 
. ? 
, ? 
? ? 
7 ; 
. Title Multiple-FPrecision Binary Subtraction : 
. Names MPBSUB ; 
? ? 
? ? 
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Purposes: Subtract 2 arrays of binary bytes 
Minuend = minuend —- subtrahend 


Entry: Register pair HL = Base address of minuend 
Register pair DE = Base address of subtrahend 
Register B = Length of the arrays 
The arrays are unsigned binary numbers with a 
maximum length of 255 bytes, ARRAYLO] is the 
least significant byte, and ARRAYCLENGTH-1] 
the most significant byte. 
Exits Minuend := minuend —- subtrahend 
Registers used: AF,B,DE,HL 
Times 46 cycles per byte plus 22 cycles overhead 


Size: Program 12 bytes 


ae =a Ve ws ws ws “MS WS WS NS NB NER NR eH NS GR UH NE UR UR MH NE 


MPBSUB: 
sCLEAR CARRY, EXIT IF ARRAY LENGTH IS 0 
LD A,B 
AND A sCLEAR CARRY, TEST ACCUMULATOR 
RET Z sRETURN IF LENGTH = ZERO 
EX DE, HL *SWITCH ARRAY POINTERS 
: SO HL POINTS TQ SUBTRAHEND 
LOOF: 
LD A, (DE) *GET NEXT BYTE OF MINUEND 
SBC A, CHL) sSUBTRACT BYTES 
LD (DE),A sSTORE DIFFERENCE 
INC DE s INCREMENT MINUEND POINTER 
INC HL. * INCREMENT SUBTRAHEND POINTER 
DWINZ LOOP sCONTINUE UNTIL COUNTER = 0 
RET 
; SAMPLE EXECUTION: 
SCG6E: 
LD HL, AY1 sHL = BASE ADDRESS OF MINUEND 
LD DE,AY2 -DE = BASE ADDRESS OF SUBTRAHEND 
LD B,SZAYS ¢B = LENGTH OF ARRAYS IN BYTES 
CALL MPBSUB sSUBTRACT THE ARRAYS 
; AY1+0 = SSH 
: AY1+1 = SSH 
: AY1i+2 = SEH 
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SZAYS 
AY1: 


DB 
DB 
DB 
DEB 
DB 
DB 
DB 
DB 


END 


E MULTIPLE-PRECISION BINARY SUBTRACTION (MPBSUB) 2do 


; LENGTH 


AY1+3 
AY1i+4 
AY1+5 
AY1I+6 
AY1+7 


=e “G@ ~S “SB WS 


OF ARRAYS IN BYTES 


SoH 
67H 
4SH 
23H 
O1H 


Multiple-Precision Binary Multiplication 


(MPBMUL) 


Multiplies two multi-byte unsigned binary 
numbers. Both numbers are stored with their 
least significant byte at the lowest address. The 
product replaces the multiplicand. The length of 
the numbers (in bytes) is 255 or less. Only the 
less significant bytes of the product are returned 
to retain compatibility with other multiple- 
precision binary operations. 

Procedure: The program uses an ordinary 
shift-and-add algorithm, adding the multiplier to 
the partial product each time it finds a | bit inthe 
multiplicand. The partial product and the multi- 
plicand are shifted through the bit length plus 1; 
the extra loop moves the final Carry into the 
product. The program maintains a full double- 
length unsigned partial product in memory 
locations starting at HIPROD (more significant 
bytes) and in the multiplicand (less significant 
bytes). The less significant bytes of the product 
replace the multiplicand as it is shifted and 


Entry Conditions 


Base address of multiplicand in HL 
Base address of multiplier in DE 
Length of the operands in bytes in B 


Example 


I. Data: Length of operands (in bytes) = 04 


Multiplicand = 0005D1F7,¢ 
Multiplier = OOO00AB1j, 


Multiplicand = 3E39DIC7;¢ 


Note that MPBMUL returns only the less 
significant bytes (that is, the number of bytes in 
the multiplicand and multiplier) of the product 
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Result: 





OF 


Registers Used: AE BC, DE, HL 


Execution Time: Depends on the length of the 
operands and on the number of | bits in the 
multiplicand (requiring actual additions). If the 
average number of | bits in the multiplicand is four 
per byte, the execution time is approximately 728 * 
LENGTH? + 883 * LENGTH + 300 cycles where 
LENGTH is the number of bytes in the operands. 


Program Size: 104 bytes 


Data Memory Required: 261 bytes anywhere in 


RAM. This is temporary storage for the more 
significant bytes of the product (255 bytes starting at 
address HIPROD), the loop counter (2 bytes starting 
at address COUNT), the address immediately follow- 
ing the most significant byte of the high product (2 
bytes starting at address ENDHP), and the base 
address of the multiplier (2 bytes starting at address 
MLIER). 


Special Case: A length of 0 causes an immediate 
exit with the product equal to the multiplicand. The 
Carry flag is cleared. 


examined for | bits. A 0 length causes an exit 
with no multiplication. 


Exit Conditions 


Multiplicand replaced by multiplicand times 
multiplier 


to maintain compatibility with other multiple- 
precision arithmetic operations. The more signif- 
icant bits of the product are available starting 
with their least significant byte at address 
HIPROD. The user may need to check those 
bytes for a possible overflow or extend the 
operands with additional zeros. 
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Title Multiple-Precision Binary Multiplication 
Name: MPBMUL 
Purpose: Multiply 2 arrays of binary bytes 


Multiplicand = multiplicand * multiplier 


Entrys Register pair HL = Base address of multiplicand 
Register pair DE = Base address of multiplier 
Register B = Length of the arrays 


The arrays are unsigned binary numbers with a 
maximum length of 255 bytes, ARRAYCO] is the 
least significant byte, and ARRAYCLENGTH-13) 
the most significant byte. 


Exits Multiplicand := multiplicand #® multiplier 


Registers used: AF,BC, DE,HL 


seo~we “we “SO “8 “SH “SE UB UR NSB wR NH WA NSB UE NS NE 


Time: Assuming the average number of 1 bits in multi- 
Plicand is 4 #® length, then the time is approxi- 
mately 


(728 ® length*’2) + (883 # length) + 300 cycles 


“we ows “8 WE NS UR 


Size: Program 104 bytes 
Data 261 bytes 


@—w8 ~8 ~s “ws wh ws 4S US WS US NR SS MR UNO UMP UNS lUMR lulu Se UR Ue eR UR UN ONS 


wa o~we ‘ae 


MPBMUL : 
;EXIT IF LENGTH IS ZERO 
LD A,B 
AND A ;IS LENGTH OF ARRAYS = 0 ? 
RET Zz 7YES, EXIT 
MAKE POINTERS POINT TQ END OF OPERANDS 
LD C,B 7;BC = LENGTH 
LD B,O 
ADD HL, BC ;END = BASE + LENGTH 
EX DE, HL 7DE POINTS TO END OF MULTIPLICAND 
LD (MLIER),HL s;SAVE ADDRESS OF MULTIPLIER 
LD HL, HIPROD 
ADD HL, BC 
LD CENDHP) , HL ;SAVE ADDRESS AT END OF HIPROD 


;SET CQUNT TO NUMBER OF BITS IN ARRAY PLUS 1 
; COUNT := (LENGTH *® 8) + 1 
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7;MOVE LENGTH TO HL 
;LENGTH ® 8, SHIFT LEFT 3 TIMES 


;AD0D 1 
7;SAVE NUMBER OF BITS TO DO 


7B = LENGTH IN BYTES 
;GET ADDRESS OF HIPROD 


7;STORE O 


;CONTINUE UNTIL HIPROD ARRAY IS ZERO 


?;MULTIPLY USING SHIFT AND ADD ALGORITHM 


;CLEAR CARRY FIRST TIME THROUGH 


;SHIFT CARRY INTO HIPROD ARRAY AND LEAST SIGNIFICANT 
; BIT OF HIPROD ARRAY TQ CARRY 


7;GET LENGTH IN BYTES 
7;GET LAST BYTE OF HIPROD + 1 


;BACK UP TO NEXT BYTE 


;CONTINUE UNTIL INDEX = 0 


s;SHIFT CARRY (NEXT BIT OF LOWER PRODUCT) INTO MOST 
; SIGNIFICANT BIT OF MULTIPLICAND. 


BIT OF MULTIPLICAND TO CARRY 
s;HL = ADDRESS OF END OF MULTIPLICAND 


7B = LENGTH IN BYTES 
7BACK UP TO NEXT BYTE 
;CONTINUE UNTIL. DONE 


7;IF NEXT BIT OF MULTIPLICAND IS 1 THEN 
>; ADD MULTIPLIER TO HIPROD ARRAY 


;JUMP IF NEXT BIT IS ZERO 


7;SAVE ADDRESS OF MULTIPLICAND 
7;DE = ADDRESS OF MULTIPLIER 
7;HL = ADDRESS OF HIPROD 

7B = LENGTH IN BYTES 

;CLEAR CARRY 


;GET NEXT MULTIPLIER BYTE 
s;ADD TO HIPROD 
7;STORE NEW HIPROD 


LD L,Cc 

LD H,B 

ADD HL, HL 

ADD HL, HL 

ADD HL, HL 

INC HL 

LD (COUNT) ,HL 

7ZERO HIGH PRODUCT ARRAY 
ZEROPD: 

LD B,C 

LD HL, HIPROD 
ZEROLP: 

LD (HL),9O 

INC HL 

DUNZ ZEROLP 

AND A 
LOOP : 

LD B,C 

LO HL, CENDHP) 
SRPLF: 

DEC HL 

RR CHL) 

DUNZ SRPLP 

; THIS ALSO SHIFTS NEXT 

LD L,E 

LD H,D 

LD B,C 
SRAILF 

DEC HL 

RR CHL > 

DUNZ SRAILP 

IP NC, DECCNT 

s;ADD MULTIPLIER TO HIPROD 

PUSH DE 

LD DE, (MLTIER) 

LD HL, HIPROD 

LD B,C 

AND A 
ADDLP s: 

LD A, (DE) 

ADC A, CHL) 

LO CHL)D,A 

INC DE 


DECCNT: 


EXIT: 


COUNT: 
ENDHP: 
MLIER: 
HIFROD: 


“wees SS NS OS 


(3 
7 
i. 
7 


SZAYS 


INC 
DJNZ 
POP 


7;DECREMENT BIT COQUNTER, 
7 DOES NOT CHANGE CARRY! 


POP 
RET 


7DATA 
DS 
DS 
DS 
DS 
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HL 
ADDLP 
DE 


A, (COUNT ) 

A 

(COUNT),A 
NZ, LOOP 

AF 

A, (CQOUNT+1) 
A 

Z,EXIT 

A 
C(COUNT+1),A 
AF 

LOOP 


AF 


Ph PI hb 


ch 
ms 


SAMPLE EXECUTION: 


JR 
EQU 


HL, AY1 
DE, AY2 
B,SZAYS 
MPBMUL 


“ND 
© 
Ls% 
TN 


7; LENGTH 


sCONTINUE UNTIL DONE 
7;RESTORE ADDRESS OF MULTIPLICAND 


EXIT IF DONE 


;BRANCH IF LSB OF COUNT NOT ZERO 
;SAVE CARRY 

7;GET HIGH BYTE OF COUNT 

; IS IT ZERO? 

; EXIT IF SO 

;DECREMENT HIGH BYTE OF COUNT 


*RESTORE CARRY 
® CONTINUE 


;DROP PSW FROM STACK 
7 RETURN 


7 TEMPORARY FOR LOOF COUNTER 
s;ADDRESS OF LAST BYTE OF HIPROD + 1 
7;ADDRESS OF MULTIPLIER 

sHIGH PRODUCT BUFFER 


HL = ADDRESS OF MULTIPLICAND 

DE = ADDRESS OF MULTIPLIER 

B = LENGTH OF OPERANDS IN BYTES 
MULTIPLE-PRECISION BINARY MULTIPLY 
RESULT OF 12345H ® 1234H = 14B60404H 


SY ee ee) ee, ee eS i) ee ) et ee) eT 


IN MEMORY AY1 = 04H 
AY1+1 = 04H 
AY1i+2 = BSH 
AY1I+3 = 14H 
AY1+4 = OOH 
AYI+5 = OOH 
AY1+4 = OOH 


QF OPERANDS IN BYTES 


=e “S "HH WR NE 
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AY1i: 
DB 0O42:H 
DB  O23H 
DB O001H 
DB a) 
DB fe) 
DB @) 
DB oO 
AY2: 
DB 034H 
DB 012H 
DB 0 
DB Q 
DB 0 
DB @) 
DB @) 


END 


Multiple-Precision Binary Division 


(MPBDIV) 


Divides two multi-byte unsigned binary 
numbers. Both numbers are storéd with their 
least significant byte at the lowest address. The 
quotient replaces the dividend; the address of 
the least significant byte of the remainder is in 
HL. The length of the numbers (in bytes) is 255 
or less. The Carry flag is cleared if no errors 
occur; if a divide by 0 is attempted, the Carry 
flag is set to 1, the dividend is left unchanged, 
and the remainder is set to 0. 

Procedure: The program divides with the 


Registers Used: AF, BC, DE, HL 


Execution Time: Depends on the length of the 
operands and onthe number of | bits in the quotient 
(requiring a buffer switch). If the average number of 
1 bits in the quotient 1s 4 per byte, the execution time 
is approximately 1176 * LENGTH?+ 2038 * LENGTH 
+ 515 cycles where LENGTH is the number of bytes 
in the operands. 


Program Size: 161 bytes 


Data Memory Required: 522 bytes anywhere in 
RAM. This is temporary storage for the high divi- 
dend (255 bytes starting at address HIDE1), the result 
of the trial subtraction (255 bytes starting at address 
HIDE2), the base address of the dividend (2 bytes 


Entry Conditions 


Base address of dividend in HL 
Base address of divisor in DE 
Length of the operands in bytes in B 


OG 


usual shift-and-subtract algorithm, shifting quo- 
tient and dividend and placing a | bit in the 
quotient each time a trial subtraction is success- 
ful. An extra buffer holds the result of the trial 
subtraction; that buffer is simply switched with 
the buffer holding the dividend if the trial 
subtraction is successful. The program exits 
immediately, setting the Carry flag, if it finds the 
divisor to be 0. The Carry flag is cleared 
otherwise. 


starting at address DVEND), the base address of the 
divisor (2 bytes starting at address DVSOR), pointers 
to the two temporary buffers for the high dividend (2 
bytes starting at addresses HDEPTR and ODEPTR, 
respectively), a loop counter (2 bytes starting at 
address COUNT), and a subtraction loop counter (1 
byte at address SUBCNT). 


Special Cases: 


1. A length of 0 causes an immediate exit with the 
Carry flag cleared, the quotient equal to the original 
dividend, and the remainder undefined. 


2. A divisor of 0 causes an exit with the Carry flag 
set to 1, the quotient equal to the original dividend, 
and the remainder equal to 0. 





Exit Conditions 


Dividend replaced by dividend divided by divisor 

If the divisor is non-zero, Carry = 0 and the 
result is normal. 

If the divisor is 0, Carry = 1, the dividend is 
unchanged, and the remainder 1s 0. 

The remainder is stored starting with its least 
significant byte at the address in HL. 
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Example 


1. Data: Length of operands (in bytes) = 03 
Divisor = 000F451¢ 
Dividend = 35A2F7\¢ 


Result: Dividend = 000383), 
Remainder (starting at address in HL) = 
0003A8 1, 
Carry flag is 0 to indicate no divide-by-0 error. 


Pt eT 


Title Multiple-Precision Binary Division 
Names MPBDIV 
Purposes Divide 2 arrays of binary bytes 


Dividend = dividend / divisor 


Entry: Register pair HL = Base address of dividend 
Register pair DE = Base address of divisar 
Register B = Length of operands in bytes 


The arrays are unsigned binary numbers with a 
Maximum length of 255 bytes, ARRAY[O] is the 
least significant byte, and ARRAYCLENGTH-1] 
the most significant byte. 


Exits Dividend := dividend / divisor 
Register pair HL = Base address of remainder 
If no errors then 
carry := 0 
ELSE 
divide-by-O error 
carry := 1 
dividend unchanged 
remainder := 0 


ot ee ee 


Registers used: AF,BC, DE, HL 


Time: Assuming there are length/2 1 bits in the 
quotient then the time is approximately 
€1176 *® length’2) + (2036 *® length) + 315 cycles 


“=e “8 NB NS NB UNE NS 


Size: Program 161 bytes 
Data vee bytes 


=e 6S 6S 


ce ee ee A ee er) ee ee) ee eT | 


St ee ee ee i) i) 


“ua 6S 


MPBDIV: 


ZEROLP: 


CHEOLP : 
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“=e 6~S 


7TEST LENGTH OF OPERANDS, INITIALIZE POINTERS 


LD A,B 

OR A *IS LENGTH OF ARRAYS = 0? 

IP Z,QKEXIT sEXIT IF sO 

LO CDOVEND), HL SAVE BASE ADDRESS QF DIVIDEND 
LD CDVSOR), DE :SAVE BASE ADDRESS OF DIVISOR 
LD C,B °C = LENGTH OF OPERANDS 

>SET COUNT TQ NUMBER OF BITS IN THE ARRAYS 

; COUNT := (CLENGTH ® &) + 1 

LO Le sHL = LENGTH IN BYTES 

LD H,9 

ADD HL, HL sLENGTH #® 2 

ADD HL, HL e*LENGTH # 4 

ADD HL, HL *LENGTH #* 8 

INC HL sLENGTH = & + 1 

LD (COUNT) , HL SAVE BIT COUNT 


7ZEROQ BOTH HIGH DIVIDEND ARRAYS 


LD HL, HIDE1 s;HL = ADDRESS OF HIDE] 
LD DE, HIDE2 ;DE = ADDRESS OF HIDE2 
LD B,C 7B = LENGTH IN BYTES 
SUB A 7;GET O FOR FILL 

LD CHLD,A ;ZERO HIDEL 

LD (DE),A ; AND HIDE2 

INC HL 

INC DE 


DUINZ ZEROLP 
7;SET HIGH DIVIDEND POINTER TO HIDEL 


LD HL, HIDE! 
LD (HDEPTR) , HL 

;SET OTHER HIGH DIVIDEND POINTER TO HIDE2 

Lo HL, HIDE2 

LD (QDEPTR) , HL 

sCHECK IF DIVISOR IS ZERQ BY LOGICALLY ORING ALL BYTES 
LD HL, (QVSOR) sHL = ADDRESS OF DIVISOR 

LD B,C ;B = LENGTH IN BYTES 

SUB A ;START LOGICAL OR AT O 

OR CHL) ;OR NEXT BYTE 

INC HL s INCREMENT TO NEXT BYTE 

DJNZ CHKOLP ;CONTINUE UNTIL ALL BYTES ORED 
OR A ;SET FLAGS FROM LOGICAL OR 

JR Z,EREXIT sERROR EXIT IF DIVISOR IS 0 


;DIVIDE USING TRIAL SUBTRACTION ALGORITHM 
OR A sCLEAR CARRY FIRST TIME THROUGH 
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LOOP : 


SLLP1s 


DECCNT : 


CONT: 


SLLP2: 


SUBLP : 


7C = LENGTH 

7;DE = ADDRESS OF DIVISOR 

;CARRY = NEXT BIT QF QUOTIENT 

;SHIFT CARRY INTQ LOWER DIVIDEND ARRAY AS NEXT BIT OF QUOTIENT 
; AND MOST SIGNIFICANT BIT OF LOWER DIVIDEND TO CARRY 


LD B,C 7B = NUMBER OF BYTES TO ROTATE 

LD HL, (DVEND) 7HL = ADDRESS OF DIVIDEND 

RL CHL) ;ROTATE BYTE OF DIVIDEND LEFT 

INC HL s;NEXT BYTE 

DINZ SLLP 1 s;CONTINUE UNTIL ALL BYTES SHIFTED 


;DECREMENT BIT COUNTER AND EXIT IF DONE 
sCARRY IS NOT CHANGED ! 


LO A, (COUNT) 

DEC A 

LD (COUNT),A 

JR NZ, CONT CONTINUE IF LOWER BYTE NOT ZERO 
LD A, (CQUNT+1) 

DEC A 

LD (COUNT+1),A 

IP M, OKEXIT sEXIT WHEN COUNT BECOMES NEGATIVE 


s;SHIFT CARRY INTQ LSB OF UPPER DIVIDEND 


LD HL, CHDEPTR) ;HL = CURRENT HIGH DIVIDEND POINTER 
LD B,C 3B = LENGTH IN BYTES 

RL CHL > sROTATE BYTE OF UPPER DIVIDEND 

INC HL. 7 INCREMENT TQ NEXT BYTE 

DUNZ SLLP2 s;CONTINUE UNTIL ALL BYTES SHIFTED 


7; SUBTRACT DIVISOR FROM HIGH DIVIDEND, 
; QTHER HIGH DIVIDEND ARRAY 


PLACE DIFFERENCE IN 


PUSH BC 7;SAVE LENGTH 

LD A,C 

LD (SUBCNT),A 7;SUBCNT = LENGTH IN BYTES 

LD BC, (QDEPTR) 7;BC = OTHER DIVIDEND 

LD DE, CHDEPTR) ;DE = HIGH DIVIDEND 

LO HL, (DVSOR) s;HL = DIVISOR 

OR A sCLEAR CARRY 

LD A, (DE) s;NEXT BYTE OF HIGH DIVIDEND 
SBC A, CHL) ;SUBTRACT DIVISOR 

LD (BC),A 3;SAVE IN OTHER HIGH DIVIDEND 
INC HL 3 INCREMENT POINTERS 

INC DE 

INC BC 

LO A, CSUBCNT ) 3;DECREMENT COUNT 

DEC A 

LD (SUBCNT),A 

JR NZ, SUBLP 7;CONTINUE UNTIL DIFFERENCE COMPLETE 
POP BC ;RESTORE LENGTH 


EREXITs: 


OKEXITs: 


EXIT: 


DVEND: 
DVSOR: 
HDEPTR: 
ONEPTR: 
COUNT: 
SUBCNT: 
HIDE1: 
HIDE2: 


«638 0~6S8 SE NB 


SCéG:s 
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IF CARRY IS 1, HIGH DIVIDEND IS LESS THAN DIVISOR 
SO NEXT BIT OF QUOTIENT IS 0. IF CARRY IS 0 

NEXT BIT OF QUOTIENT IS 1 AND WE REPLACE DIVIDEND 
WITH REMAINDER BY SWITCHING POINTERS. 


as ~s “e “8 


CCF 7COMPLEMENT BORROW SO IT EQUALS 
; NEXT BIT OF QUOTIENT 

JR NC, LOOP 7;JUMP IF NEXT BIT OF QUOTIENT O 

LO HL, CHDEPTR) sOTHERWISE EXCHANGE HDEPTR AND QDEPTR 

LO DE, (QDEPTR) 

LD CODEPTR), HL 

LD CHDEPTR), DE 

sCONTINUE WITH NEXT BIT OF QUOTIENT 1 (CARRY = 1) 

JP LOOP 

;SET CARRY TQ INDICATE DIVIDE-BY-ZERO ERROR 

SCF 7;SET CARRY, INVALID RESULT 

UIP EXIT 

7;CLEAR CARRY TO INDICATE NO ERRORS 

QR A 7;CLEAR CARRY, VALID RESULT 


sARRAY 1 IS QUOTIENT 
s;HDEPTR CONTAINS ADDRESS OF REMAINDER 


LD HL, (HDEPTR) 7;HL = BASE ADDRESS OF REMAINDER 

RET 

7 DATA 

DS 2 ;ADDRESS OF DIVIDEND 

DS 2 s;ADDRESS OF DIVISOR 

DS 2 ;ADDRESS OF CURRENT HIGH DIVIDEND ARRAY 
DS 2 ;ADDRESS OF OTHER HIGH DIVIDEND ARRAY 
DS 2 7 TEMPORARY FOR LOOP COUNTER 

DS 1 ;SUBTRACT LOOP COUNT 

DS 253 sHIGH DIVIDEND BUFFER 1 

DS 255 sHIGH DIVIDEND BUFFER 2 


SAMPLE EXECUTION: 


“wa we ws us SR 


LD HL, AY1 s;HL = BASE ADDRESS OF DIVIDEND 

LD DE, AY2 7;DE = BASE ADDRESS OF DIVISOR 

LD B,SZAYS 7B = LENGTH OF ARRAYS IN BYTES 
CALL. MPBDIV s;MULTIPLE-PRECISION BINARY DIVIDE 


sRESULT OF 14B60404H / 1234H = 12345H 


; IN MEMORY AY1 = 45H 
; AY1i+1 = 23H 
; AY1+2 = O1H 
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SZAYS 
AY1: 


ARITHMETIC 


JR 
EQU 


DB 
DB 
DB 
DB 
DB 
DB 
DB 


DB 


DB 
DB 
DB 
DB 
DB 


END 


f, 
&) 


“ 


004H 
004H 
OBGH 
014H 


7 LENGTH 


AY1I+3 
AY1+4 
AY1+5 
AY1+6 


“us “2S SS “SES 


QF ARRAYS IN BYTES 


OOH 
OOH 
OOH 
OOH 


Multiple-Precision Binary Comparison 


(MPBCMP) 


Compares two multi-byte unsigned binary 
numbers and sets the Carry and Zero flags 
appropriately. The Zero flag is set to 1 if the 
operands are equal and to 0 if they are not equal. 
The Carry flag is set to | if the subtrahend is 
larger than the minuend; the Carry flag is 
cleared otherwise. Thus, the flags are set as if the 
subtrahend had been subtracted from the 
minuend. 

Procedure: The program compares the oper- 
ands one byte at a time, starting with the most 
significant bytes and continuing until it finds 
corresponding bytes that are not equal. If all the 
bytes are equal, it exits with the Zero flag set to 
1. Note that the comparison works through the 
operands starting with the most significant 
bytes, whereas the subtraction (Subroutine 6E) 
starts with the least significant bytes. 


Entry Conditions 


Base address of minuend in HL 
Base address of subtrahend in DE 
Length of the operands in bytes in B 


Examples 


1. Data: Length of operands (in bytes) = 6 
Subtrahend = 19D028A193EA 4, 


Minuend = 4E67BC15A266,¢ 


Zero flag = 0 (operands are not equal) 
Carry flag = 0 (subtrahend is not larger than 
minuend) 


Result: 





On 


Registers Used: AF, BC, DE, HL 


Execution Time: 44 cycles per byte that must be 
examined plus approximately 60 cycles overhead. 
That is, the program continues until it finds cor- 
responding bytes that are not the same; each pair of 
bytes it must examine requires 44 cycles. 


Examples: 


1. Comparing two 6-byte numbers that are equal: 
44* 6+ 60= 324 cycles 


2. Comparing two 8-byte numbers that differ in 
the next to most significant bytes: 
44*2+ 60= 148 cycles 


Program Size: 19 bytes 
Data Memory Required: None 


Special Case: A length of 0 causes an immediate 
exit with the Carry flag cleared and the Zero flag set 
to 1. 


Exit Conditions 


Flags set as if subtrahend had been subtracted 
from minuend. 


Zero flag = 1 if subtrahend and minuend are 
equal, 0 if they are not equal. 


Carry flag = 1 if subtrahend is larger than 
minuend in the unsigned sense, 0 if it is less 
than or equal to the minuend. 


3. Data: Length of operands (in bytes) = 6 
Subtrahend = 19D028A193EAj¢ 
Minuend = 0F37E5991D7Ci¢ 
Result: Zero flag = 0 (operands are not equal) 


Carry flag = | (subtrahend is larger than 
minuend) 
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2. Data: Length of operands (in bytes) = 6 
Subtrahend = 19D028A193EAj¢ 
Minuend = 19D028A 193EAj¢ 


Result: Zero flag = | (operands are equal) 
Carry flag = 0 (subtrahend is not larger than 


Registers used: AF,BC, DE, HL 


Times: 44 cycles per byte that must be examined plus 
60 cycles overhead 


Sizes Pragram 19 bytes 


minuend) 
: Title Multiple-Precision Binary Comparison 
: Name: MPBCMP 
: Purposes Compare 2 arrays of binary bytes and return 
; the Carry and Zera flags set or cleared 
: Entrys Register pair HL = Base address of minuend 
3 Register pair DE = Base address of subtrahend 
; Register B = Length of aperands in bytes 
: The arrays are unsigned binary numbers with a 
; maximum length af 255 bytes, ARRAY[O] is the 
; least siqnificant byte, and ARRAYCLENGTH-11 
; the most significant byte. 
; Exits IF minuend = subtrahend THEN 
; C=0, Z=1 
; IF minuend > subtrahend THEN 
; =0, Z=0 
; IF minuend < subtrahend THEN 
H C=1,Z=0 


MPBCMP : 
7 TEST LENGTH OF OPERANDS, SET POINTERS TO MSB“S 
LD A,B 
OR A 71S LENGTH OF ARRAYS = 07? 
RET Zz 7;YES, EXIT WITH C=0, Z=1 
LD C,B 7;BC = LENGTH 


a a i | i) | 


a ee ee ee | ee) ee ee ee 
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LD B,O 

ADD HL., BC 

EX DE, HL 7;DE POINTS TO END OF MINUEND 
ADD HL, BC 7;HL POINTS TQ END OF SUBTRAHEND 
LD B,C 7B = LENGTH 

OR A s;CLEAR CARRY INITIALLY 


;SUBTRACT BYTES, STARTING WITH MOST SIGNIFICANT 
sEXIT WITH FLAGS SET IF CORRESPONDING BYTES NOT EQUAL 


LOOP: 
DEC HL. sBACK UP TO LESS SIGNIFICANT BYTE 
DEC DE 
LD A, (DE) °*GET NEXT BYTE OF MINUEND 
SBC A, (HL) sSUBTRACT BYTE OF SUBTRAHEND 
RET NZ sRETURN IF NOT EQUAL WITH FLAGS 
; SET 
DJINZ LOOP sCONTINUE UNTIL ALL BYTES COMPARED 
RET ;EQUAL, RETURN WITH C=0, Z=1 
; SAMPLE EXECUTION: ; 
SC6H: 
LD HL, AY1 sHL = BASE ADDRESS OF MINUEND 
LD DE, AY2 sDE = BASE ADDRESS OF SUBTRAHEND 
LD B,SZAYS ?B = LENGTH OF OPERANDS IN BYTES 
CALL MPBCMP sMULTIPLE-PRECISIOQN BINARY COMPARISON 
sRESULT QF COMPARE (7654321H, 1234567H) IS 
> C=0,7Z=0 
JR SC46H 
SZAYS EQU 7 sLENGTH OF OPERANDS IN BYTES 
AYis: 
DB O21H 
DB 043H 
DB 065H 
DB 007H 
DB Q 
DB fe) 
DB Oo 
AY2: 
DB 067H 
DB 045H 
DB 023H 
DB Q01H 
DB @) 
DB 0 
DB .@ 


END 


Multiple-Precision Decimal Addition 
(MPDADD) 6| 


Adds two multi-byte unsigned decimal num- 


bers. Both numbers are stored with their least Registers Used: AF, B, DE, HL 
significant digits at the lowest address. The sum Execution Time: 50 cycles per byte plus 18 cycles 
replaces the addend. The length of the numbers overhead 
(in bytes) is 255 or less. Program Size: 12 bytes 
Procedure: The program first clears the Carry Data Memory Required: None 


flag and then adds the operands one byte (two ange ven veaeon apae ht mien 
digits) at a time, starting with the least significant ener Se RES en hg ere wee te 
digits. The sum replaces the addend. A length of 

00 causes an immediate exit with no addition. 
The final Carry flag reflects the addition of the 
most significant digits. 





Entry Conditions Exit Conditions 


Base address of addend in HL Addend replaced by addend plus adder 
Base address of adder in DE 
Length of the operands in bytes in register B 


Example 


1. Data: Length of operands (in bytes) = 6 
Addend = 196028819315. 
Adder = 293471605987 1¢ 


Result: © Addend = 489500425302), 


Carry = 0 
; Title Multiple-Precision Decimal Addition . H 
: Name: MPDADD ; 
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ue “8 “Ss “Se “SB “SA NS WS YS UH wR UB MA US UNE UMS NEUE UNE UR ONS 


MPOADD: 


LOOP: 


ws “8 WS 


=e “8 


SC6I: 


Purposes 


Entrys 


Exits 


Registers used: 


Time: 


Size: 
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Add 2 arrays of BCD bytes 
Arrayl = Arrayi + Array2 


Register pair HL = Base address of array i 

Register pair DE = Base address of array 2 

Register B = Length of arrays in bytes 
The arrays are unsigned BCD numbers with a 
maximum length of 255 bytes, ARRAYCO] is the 
least significant byte, and ARRAYCLENGTH-1] 
the most significant byte. 

Arrayl := Arrayl + Array2 

A,B, DE,F,HL 

530 cycles per byte plus 18 cycles overhead 


Program 12 bytes 


=a “we “ws “8 “BSB NA ONE UNSER lM UNS UMS UMA MAR VR NE eR NEA WR UNE UMS Ne 


;TEST ARRAY LENGTH FOR ZERQ, CLEAR CARRY 


LD 
OR 
RET 


A,B 
A 
Zz 


;TEST LENGTH AND CLEAR CARRY 
sEXIT IF LENGTH IS 0 


sADD OPERANDS 2 DIGITS AT A TIME 
; NOTE CARRY IS 0 INITIALLY 


LD A, (DE) 

ADC A, CHL) 7;ADD NEXT BYTES 

DAA 3 CHANGE TO DECIMAL 

LD CHL),A ;STORE SUM 

INC HL 7 INCREMENT TO NEXT BYTE 

INC DE 

DJINZ LOOP ?CONTINUE UNTIL ALL BYTES SUMMED 
RET 


SAMPLE EXECUTION: 


LD HL, AY1 sHL = BASE ADDRESS OF ARRAY 1 

LD DE, AY2 7;DE = BASE ADDRESS OF ARRAY 2 

LD B,SZAYS 7B = LENGTH OF ARRAYS IN BYTES 
CALL MPDADD ?MULTIPLE-PRECISION BCD ADDITION 


7;RESULT OF 1234567 + 1234567 = 2469134 


> IN MEMORY AY1 = 34H 
7 AY1i+1 = 91H 
7 AY1I+2 = 46H 


—e “se ws wa we 
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AY1: 


AY2: 


ARITHMETIC 


DE 
DB 
DB 
DB 
DB 
DB 
DE 


END 


SCé6I 


067H 
043H 
OZ3H 
OO1H 


067H 
045H 
023H 
001H 


7 LENGTH 


AY1i+23 
AY1+4 
AY1+5 
AY1+é 


=e 68 UR wR 


OF ARRAYS IN BYTES 


ion it wl 


O2H 
OOH 
OOH 
OOH 


Multiple-Precision Decimal Subtraction 


(MPDSUB) 


Subtracts two multi-byte unsigned decimal 
numbers. Both numbers are stored with their 
least significant digits at the lowest address. The 
difference replaces the minuend. The length of 
the numbers (in bytes) is 255 or less. 

Procedure: The program first clears the Carry 
flag and then subtracts the subtrahend from the 
minuend one byte (two digits) at a time, starting 
with the least significant digits. A length of 0 
Causes an immediate exit with no subtraction. 
The final Carry flag reflects the subtraction of 
the most significant digits. 


Entry Conditions 


Base address of minuend in HL 
Base address of subtrahend in DE 
Length of the operands in bytes in B 


Example 


1. Data: Length of operands (in bytes) = 6 
Minuend = 293471605987 i¢ 
Subtrahend = 1960288193151 1, 


Result: | Minuend = 097442786672), 
Carry = 0, since no borrow is necessary 


Name: MPDSUB 


“up “SH <8 M8 US UR UR OB 


“8 


Title Multiple-Precision Decimal Subtraction 


OJ 


Registers Used: A, B, DE, F HL 


Execution Time: 50 cycles per byte plus 22 cycles 
overhead 


Program Size: 13 bytes 


Data Memory Required: None 


Special Case: A length of 0 causes an immediate 
exit with the minuend unchanged (that is, the 
difference is equal to the minuend). The Carry flag is 
cleared. 





Exit Conditions 


Minuend replaced by minuend minus subtrahend 


ye, ee ee) ee ee ee eT | 
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MPDSUB: 


LOOP : 


ws 4S se SSH MS 


CéJ 


Purpose: 


Entrys 


Exits 


Registers used: 


Time: 


Sizes 


Subtract 2 arrays of BCD bytes 
Minuend = minuend —- subtrahend 


Register pair HL = Base address of minuend 

Register pair DE = Base address of subtrahend 

Register B = Length of arrays in bytes 
The arrays are unsigned BCD numbers with a 
maximum length of 255 bytes, ARRAY£LO] is the 
least significant byte, and ARRAYCLENGTH-1] 
the most significant byte. 

Minuend := minuend —- subtrahend 

A,B, DE,F,HL 

50 cycles per byte plus 22 cycles overhead 


Program 13 bytes 


7;TEST ARRAY LENGTH FOR ZERO, CLEAR CARRY 


LD 
QR 
RET 
EX 


? 


A 
Zz 
DE, HL 


;TEST ARRAY LENGTH, CLEAR CARRY 
sEXIT IF LENGTH IS 0 

s;HL = SUBTRAHEND 

7;DE = MINUEND 


;SUBTRACT OPERANDS 2 DIGITS AT A TIME 


; NOTE CARRY IS 


LD 
SBC 
DAA 
LD 
INC 
INC 
DUINZ 
RET 


A, (DE) 
A, CHL) 


INITIALLY 0 


sGET BYTE OF MINUEND 
;SUBTRACT BYTE OF SUBTRAHEND 
sCHANGE TO DECIMAL 

;STORE BYTE OF DIFFERENCE 

7; INCREMENT TQ NEXT BYTE 


sCONTINUE UNTIL ALL BYTES SUBTRACTED 


SAMPLE EXECUTION: 


LD 
LD 
LD 
CALL 


HL, AY1 


DE, AY2 
B,SZAYS 
MPDSUB 


;HL = BASE ADDRESS OF MINUEND 
7;DE.= BASE ADDRESS OF SUBTRAHEND 


7B = LENGTH OF ARRAYS IN BYTES 
*;MULTIPLE-PRECISION BCD SUBTRACTION 
;RESULT OF 2469134 — 1234567 = 1234567 
IN MEMORY AY1 = 6 
AY1+1 = 43H 


<3 “8 


a i en 


=p “6 “Sk VR “SE 


=a 6“S 


ot i) i! St eS | 


ws 6“G8 “ws “WS WE 
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: AYiI+2 = 23H 
; AY1+23 = O1H 
; AY1+4 = OOH 
; AY1+5 = OOH 
; AY1I+6 = OOH 
JR $céJ 
SZAYS EQU 7 sLENGTH OF ARRAYS IN BYTES 
AY1: 
DB 034H 
DB O91H 
DB 046H 
DB 002H 
DB oO 
DOB ‘@) 
DB O 
AY2: 
DB 067H 
DB 045H 
DB O23H 
DB O0O1H 
DB QO 
DB O 
DB 2 


END 


Multiple-Precision Decimal Multiplication 


(MPDMUL) 


Multiplies two multi-byte unsigned decimal 
numbers. Both numbers are stored with their 
least significant digits at the lowest address. The 
product replaces the multiplicand. The length of 
the numbers (in bytes) is 255 or less. Only the 
least significant bytes of the product are returned 
to retain compatibility with other multiple- 
precision decimal operations. 

Procedure: The program handles each digit of 
the multiplicand separately. It masks the digit 
off, shifts it (if it is the upper nibble of a byte), 
and then uses it as a counter to determine how 
many times to add the multiplier to the partial 
product. The least significant digit of the partial 
product is saved as the next digit of the full 
product and the partial product is shifted right 
four bits. The program uses a flag to determine 
whether it is currently working with the upper or 
lower digit of a byte. A length of 00 causes an 
exit with no multiplication. 


Entry Conditions 


Base address of multiplicand in HL 
Base address of multiplier in DE 
Length of the operands in bytes in B 


Example 


1. Data: Length of operands (in bytes) = 04 
Multiplier = 00003518 1, 


Multiplicand = 00006294, 


Result: Multiplicand = 22142292), 


254 


OK 


Registers Used: AF, BC, DE, HL 


Execution Time: Depends on the length of the 
operands and on the size of the digits in the 
multiplicand (since those digits determine how many 
times the multiplier must be added to the partial 
product). If the average digit in the multiplicand has 
a value of 5, then the execution time is approximately 
694 * LENGTH? + 1555 * LENGTH + 272 cycles 
where LENGTH is the number of bytes in the 
operands. 


Program Size: 167 bytes 


Data Memory Required: 520 bytes anywhere in 
RAM. This is temporary storage for the high bytes of 
the partial product (255 bytes starting at address 
PROD), the multiplicand (255 bytes starting at 
address MCAND), the length of the arrays (1 byte at 
address LEN), a digit counter indicating upper or 
lower digit (1 byte at address DCNT), a loop counter 
(1 byte at address LPCNT), an overflow byte (1 byte 
at address OVRFLW), pointers to the multiplicand 
and multiplier (2 bytes each starting at addresses 
MCADR and MPADR, respectively), and the next 
byte of the multiplicand (1 byte at address NBYTE). 
Special Case: A length of 0 causes an immediate 
exit with the multiplicand unchanged. The more 


significant bytes of the product (starting at address 
PROD) are undefined. 





Exit Conditions 


Multiplicand replaced by multiplicand times 
multiplier 


Note that MPDMUL returns only the less sig- 
nificant bytes of the product (that is, the number 
of bytes in the multiplicand and multiplier) to 
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maintain compatibility with other multiple- address PROD. The user may need to check 
precision decimal arithmetic operations. The those bytes fora possible overflow or extend the 
more significant bytes of the product are avail- operands with zeros. 

able starting with their least significant digits at 


“ses «ge 


“se “~@ “8S MS “SBS hUNEB UNS ONS 


; Title Multiple-Precision Decimal Multiplication 
; Name: MPDMUL / 
Purpose: Multiply 2 arrays of BCD bytes 


Multiplicand = multiplicand * multiplier 


Entry: Register pair HL = Multiplicand base address 
Register pair DE = Multiplier base address 
Register B = Length of arrays in bytes 


The arrays are unsigned BCD numbers with a 
maximum length of 255 bytes, ARRAY[CO] is the 
least significant byte, and ARRAYCLENGTH-1] 
the most significant byte. 


Exits Multiplicand := multiplicand * multiplier 
Registers used: AF, BC,DE,HL 
Times: Assuming the average digit value of multiplicand 


is 3, the time is approximately 
(694 *® length’2) + (1555 * length) + 272 cycles 


OL ee) ee ee) t,o 


Size: Program 167 bytes 
Data 5320 bytes 


at i) ee) ee ee ee | ee ee 


wa “BO OS MR SE 


MPDMUL: 
7 INITIALIZE COUNTERS AND POINTERS 
LD A,B 7TEST LENGTH OF OPERANDS 
QR A 
RET Zz s;EXIT IF LENGTH IS 0 
LD (LEN),A ;SAVE LENGTH 
LD (LPCNT),A 7;LOOP COUNTER = LENGTH IN BYTES 
LD (MCADR), HL ;SAVE MULTIPLICAND ADDRESS 


LD (MPADR) , DE 7;SAVE MULTIPLIER ADDRESS 
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LOOP: 


DLOOF : 


DLOOP 1: 


ADDLP : 


INNER: 


7;SAVE MULTIPLICAND IN TEMPORARY BUFFER (MCAND) 


LD DE, MCAND 7;DE POINTS TO TEMPORARY MULTIPLICAND 
LD (NBYTE), DE 
7;HL POINTS TO MULTIPLICAND 
LD C,B 3;BC = LENGTH 
LD B,O 
LDIR ;MOVE MULTIPLICAND TO BUFFER 


7CLEAR PARTIAL PRODUCT, CONSISTING OF UPPER BYTES 
; STARTING AT PROD AND LOWER BYTES REPLACING 


; MULTIPLICAND 

LD HL, (MCADR ) 

LD A, (LEN) 

CALL ZEROBUF ZERO MULTIPLICAND 
7ZERQ PRODUCT 

LD HL, PROD 

CALL ZEROBUF ZERO PRODUCT ARRAY 


7;LOOP THROUGH ALL BYTES OF MULTIPLICAND 


LD A,1 
LD (DCNT),A ;START WITH LOWER DIGIT 


7;LOOP THROUGH 2 DIGITS PER BYTE 
7 DURING LOWER DIGIT DCNT = 1 
> DURING UPPER DIGIT DCNT = 0 


SUB 4 sA = 0 

LO CQVRFLW),A CLEAR QVERFLOW BYTE 

LD A, (DCNT) 

OR A s TEST FOR LOWER DIGIT (Z=0) 
LD HL, (NBYTE) s;GET NEXT BYTE 

LO A, CHL) 

JR NZ, DLOOP 1 sJUMP IF LOWER DIGIT 

RRCA sSHIFT UPPER DIGIT RIGHT 4 BITS 
RRCA 

RRCA 

RRCA 

AND OFH sKEEP ONLY CURRENT DIGIT 
JR Z,SDIGIT BRANCH IF DIGIT IS ZERO 
LD C,A °C = DIGIT 


s;ADD MULTIPLIER TO PRODUCT NDIGIT TIMES 


LD HL, (MPADR) sHL = MULTIPLIER ADDRESS 
LD DE, PROD 7DE = PRODUCT ADDRESS 

LD A, (LEN) 

LD B,A 7B = LENGTH 

OR A s;CLEAR CARRY INITIALLY 
LD A, (DE) s;GET NEXT BYTE OF PRODUCT 


ADC A, CHL) ADD NEXT BYTE OF MULTIPLIER 


DECND: 


SDIGIT: 


SHFTLP : 


6K MULTIPLE-PRECISION DECIMAL MULTIPLICATION (MPDMUL) 257 


DAA 7;DECIMAL ADJUST 

LD (DE),A 7;STORE SUM IN PRODUCT 

INC HL 

INC DE 

DINZ INNER s;CONTINUE UNTIL ALL BYTES ADDED 

JR NC, DECND ;JUMP IF NO OVERFLOW FROM ADDITION 
LD HL, QVRFLW s;ELSE INCREMENT OVERFLOW BYTE 

INC CHL > 

DEC Cc 

JR NZ, ADDLP sCONTINUE UNTIL DIGIT = 0 


;STORE LEAST SIGNIFICANT DIGIT OF PRODUCT 
> AS NEXT DIGIT OF MULTIPLICAND 


LD A, (PROD) *GET LOW BYTE OF PRODUCT 

AND OFH 

LD B,A sSAVE IN B 

LO A, (DCNT) 

OR A *TEST FOR LOWER DIGIT (Z=0) 

LD A, E 7A = NEXT DIGIT 

JR NZ,SD1 JUMP IF WORKING ON LOWER: DIGIT 
RRCA sELSE MOVE DIGIT TO HIGH BITS 
RRCOA 

RRCA 

RRCA 

LO HL, (MCADR) sPLACE NEXT DIGIT IN MULTIPLICAND 
OR CHL) 

LD CHLD,A 

sSHIFT PRODUCT RIGHT 1 DIGIT (4 BITS) 

LD A, (LEN) 

LO B,A 3B = LENGTH 

LD E,A 

LD 0,o 

LD HL, PROD 

ADD HL, DE sHL POINTS BEYOND END OF PROD 

LD A, (OVRFLW) >A = OVERFLOW BYTE 

DEC HL sDECREMENT, POINT TQ NEXT BYTE 
RROD sROTATE BYTE OF PRODUCT RIGHT 1 DIGIT 
DINZ SHFTLP sCQNTINUE UNTIL DONE 

sCHECK IF DONE WITH BOTH DIGITS OF THIS BYTE 

LD HL, OCNT s;ARE WE ON LOWER DIGIT? 

DEC CHL) 

JR Z, DLQOP ‘YES, DQ UPPER DIGIT QF SAME BYTE 
s INCREMENT TO NEXT BYTE AND SEE IF DONE 

LOD HL, (NBYTE) sINCREMENT TO NEXT MULTIPLICAND BYTE 
INC HL. 


LD (NBYTE), HL 


258 aRTHMETIC 


EXIT: 


ZEROBUF : 


LEN: 
DCNT: 
LPCNT: 
OVRFLW: 
MCADR: 
MPADR: 
NBYTE: 
PROD: . 
MCAND: 


—s ~8 ws SS US 


SC6K : 


LD HL, (MCADR) 7 INCREMENT TQ NEXT RESULT BYTE 
INC HL 

LD (MCADR) , HL 

LD HL, LPCNT ;DECREMENT LOOP COUNTER 

DEC CHL) 

JR NZ, LOOP 

RET 


sROUTINE: ZEROBUF 

;PURPOSE: ZERQ A BUFFER 

;ENTRY: HL POINTS TO FIRST BYTE OF BUFFER 
; LEN = LENGTH OF BUFFER 

sEXIT: BUFFER ZEROED 

;REGISTERS USED: AF,BC, DE, HL 


LD CHL),0 7ZERO FIRST BYTE 

LD A, (LEN) 

DEC A 

RET Zz s;RETURN IF ONLY ONE BYTE 

LD D,H 

LD E,L 

INC DE ;DE = SECOND BYTE 

LD C,A ;BC = LENGTH OF ARRAY 

LD B,O0 

LDIR ;CLEAR REST OF BUFFER BY 

RET ; PROPAGATING ZEROS FROM ONE 
; BYTE TO THE NEXT 

+DATA 

DS 1 ;LENGTH OF ARRAYS 

DS 1 ;DIGIT COUNTER FOR BYTES 

DS 1 7;LOOP COUNTER 

DS 1 ;QVERFLOW BYTE 

DS 2 ;NEXT BYTE TO STORE INTO 

DS 2 ;ADDRESS OF MULTIPLIER 

DS 2 s;NEXT DIGIT OF MULTIPLICAND 

BS 209 ;PRODUCT BUFFER 

DS 299 sMULTIPLICAND BUFFER 


SAMPLE EXECUTION: 


LD HL, AY1 ;BASE ADDRESS OF MULTIPLICAND 

LD DE, AY2 7;BASE ADDRESS OF MULTIPLIER 

LD B,SZAYS ;LENGTH OF ARRAYS IN BYTES 

CALL MPDMUL ;MULTIPLE-PRECISION BCD MULTIPLICATION 


sRESULT OF 1234 ® 1234 = 1522756 


=a 6=u8 M8 NE SS 
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IN MEMORY AY1 OH 


; AYi+ti = 27H 
: AY1+2 = 52H 
: AY1i+3 = O1H 
: AY1+4 = OOH 
: AY1+5 = OOH 
: AY1+6 = OOH 
JR SCéK 
SZAYS EQu 7 sLENGTH OF ARRAYS IN BYTES 
AY1is: 
DB 034H 
DB O12H 
DB 0 
DB 2) 
DB 0 
DBS 0 
DB oO 
AY2: 
DB 034H 
De 012H 
DB 0 
DB a) 
DB QO 
DnB ‘e) 
DE 0 


END 


Multiple-Precision Decimal Division 


(MPDDIV) 


Divides two multi-byte unsigned decimal 
numbers. Both numbers are stored with their 
least significant digits at the lowest address. The 
quotient replaces the dividend; the remainder is 
not returned, but its base address is in memory 
locations HDEPTR and HDEPTR+1. The 
length of the numbers (in bytes) is 255 or less. 
The Carry flag is cleared if no errors occur; if a 
divide by 0 is attempted, the Carry flag is set to 
1, the dividend is unchanged, and the remainder 
is set to 0. 


Registers Used: AF, BC, DE, HL 


Execution Time: Depends on the length of the 
operands and on the size of the digits in the 
quotient (determining how many times the divisor 
must be subtracted from the dividend). If the 
average digit in the quotient has a value of 5, the 
execution time is approximately 1054 * LENGTH? + 


2297 * LENGTH + 390 cycles where LENGTH is the 
number of bytes in the operands. 


Program Size: 168 bytes 


Data Memory Required: 523 bytes anywhere in 
RAM. This is storage for the high dividend (255 
bytes starting at address HIDE1), the result of the 
subtraction (255 bytes starting at address HIDE2), 
the length of the operands (1 byte at address 


Entry Conditions 
Base address of dividend in HL 


Base address of divisor in DE 
Length of the operands in bytes in B 


260 


OL 


Procedure: The program divides by determin- 
ing how many times the divisor can be subtracted 
from the dividend. It saves that number in the 
quotient, makes the remainder into the new 
dividend, and rotates the dividend and the 
quotient left one digit. The program exits 
immediately, setting the Carry flag, if it finds 
the divisor to be 0. The Carry flag is cleared 
otherwise. 


LENGTH), the next digit in the array (1 byte at 
address NDIGIT), the counter for the subtraction 
loop (1 byte at address CNT), pointers to the 
dividend, divisor, current high dividend and remain- 
der, and other high dividend (2 bytes each starting at 
addresses DVADR, DSADR, HDEPTR, and 
ODEPTR, respectively), and the divide loop counter 
(2 bytes starting at address COUNT). 


Special Cases: 
1. Alength of 0 causes an immediate exit with the 


Carry flag cleared, the quotient equal to the original 
dividend, and the remainder undefined. 


2. Adivisor of 0 causes an exit with the Carry flag 
set to 1, the quotient equal to the original dividend, 
and the remainder equal to 0. 





Exit Conditions 


Dividend replaced by dividend divided by divisor 

If the divisor is non-zero, Carry = 0 and the 
result is normal. 

If the divisor is 0, Carry = 1, the dividend is 
unchanged, and the remainder is 0. 

The base address of the remainder (i.e., the 
address of its least significant digits) is in 
HDEPTR and HDEPTR+1. 
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Example 


1. Data: Length of operands (in bytes) = 04 
Dividend = 22142298, 
Divisor = 00006294 j¢ 


Result: Dividend = 00003518, 
Remainder (base address in HDEPTR and 
HDEPTR + 1) = 00000006). 
Carry flag is 0 to indicate no divide-by-0 error. 


=eo6s h6wAR UWE UO lhULSE UR OB 
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Title Multiple-Precision Decimal Division 
Name: MPDDIV 
Purpose: Divide 2 arrays of BCD bytes 


Quotient = dividend / divisor 


“uae va “MS NO 


Entrys Register pair HL = Base address of dividend 
Register pair DE = Base address of divisor 
Register B = Length of operands in bytes 


The arrays are unsigned BCD numbers with a 
maximum length of 255 bytes, ARRAYCO] is the 
least significant byte, and ARRAYCLENGTH-1] 
the most significant byte. 


Exit: Dividend := dividend / divisor 

Remainder := base address in HDEPTR 
If no errors then 

carry := 0 
ELSE 

divide-by-O errar 

Carry := 1 

dividend unchanged 

remainder := 0 


“sos “8B “SB wR YS WEA US WA OMS NB UE UR le ME UNS 


Registers used: AF,EBC, DE, HL 


Time: Assuming the average digit value in the 
quotient is 3 then the time is approximately 
(1054 * length*’2) + (22977 ® length) + 390 cycles 


Size: Program 168 bytes 
Data wea bytes 
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MPDDIV: 


INITLP: 


DVO1s 


3SAVE PARAMETERS AND CHECK FOR ZERO LENGTH 


Lo (DVADR), HL ;SAVE DIVIDEND ADDRESS 
LD (DSADR) , DE ;SAVE DIVISOR ADDRESS 
Lo A,5 

LD (LENGTH) ,A 3SAVE LENGTH 

OR A 7TEST LENGTH 

JP Z,QKEXIT sEXIT IF LENGTH = 0 


7ZEROQ BOTH DIVIDEND BUFFERS 
; AND SET UP THE DIVIDEND POINTERS 


LD HL, HIDE! sHL = ADDRESS QF HIGH DIVIDEND 1 
LO (HDEPTR), HL sHIGH DIVIDEND PTR = HIDE 

LO DE, HIDE2 ;DE = ADDRESS OF HIGH DIVIDEND 2 
LD CODEPTR), DE sQTHER DIVIDEND PTR = HIDE2 

SUB A s;GET O TQ USE IN FILLING BUFFERS 


7B = LENGTH IN BYTES 
sFILL BOTH DIVIDEND BUFFERS WITH ZEROS 


LD (HL),A 7;ZERO BYTE OF HIDE1 
LD (DE),A ;ZEROQ BYTE OF HIDE2 
INC HL 
INC DE 


DUNZ INITLP 


;SET COUNT TO NUMBER OF DIGITS PLUS 1 
; COUNT := (LENGTH ® 2) + 1; 

LO A, (LENGTH) sEXTEND LENGTH TO 16 BITS 
Lo LA 

LD H,0 

ADD HL, HL sLENGTH # 2 

INC HL ;LENGTH * 2 + 1 

LD (COUNT) , HL sCOUNT = LENGTH = 2 + 1 


7;CHECK FOR DIVIDE BY ZERO 
3 LOGICALLY OR ENTIRE DIVISOR TO SEE IF ALL BYTES ARE 0O 


LD HL, (DSADR) sHL = ADDRESS OF DIVISOR 
LD A, (LENGTH) 

LD B,A 7B = LENGTH IN BYTES 

SUB a 3;START LOGICAL OR WITH O 
OR CHL) 7;OR NEXT BYTE OF DIVISOR 
INC HL 

DVJINZ DVO! 

OR A 7TEST FOR ZERO DIVISOR 
IR Z,EREXIT s;ERROR EXIT IF DIVISOR IS 0 
SUB A 

Lo (NDIGIT),A ;START NEXT DIGIT AT O 


s;DIVIDE BY DETERMINING HOW MANY TIMES DIVISOR CAN 
; BE SUBTRACTED FROM DIVIDEND FOR EACH DIGIT 
7 POSITION 


DVLOOF : 


SUBLF': 


INNER: 
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sROTATE LEFT LOWER DIVIDEND AND QUOTIENT: 

HIGH DIGIT OF NDIGIT BECOMES LEAST SIGNIFICANT DIGIT 

QF QUOTIENT CDIVIDEND ARRAY) AND MOST SIGNIFICANT DIGIT 
OF DIVIDEND ARRAY GOES TO HIGH DIGIT OF NDIGIT 

LD HL, (DVADR) 
CALL RLARY 


"6 “Ss “ES 


sROTATE LOW DIVIDEND 


IF DIGIT COUNT = 0 THEN WE ARE DONE 


LD HL, C(CQUNT) sDECREMENT COUNT BY 1 

DEC HL 

LD (COUNT) , HL 

LD A,H sTEST 16-BIT COUNT FOR 0 
OR L 

JR Z,OQKEXIT sEXIT WHEN COUNT = 0 
;ROTATE LEFT HIGH DIVIDEND, LEAST SIGNIFICANT DIGIT 
; OF HIGH DIVIDEND BECOMES HIGH DIGIT OF NDIGIT 

LD HL, (CHDEPTR) 

CALL RLARY s;ROTATE HIGH DIVIDEND 


SEE HOW MANY TIMES DIVISOR GOES INTO HIGH DIVIDEND 
QN EXIT FROM THIS LOOP, HIGH DIGIT OF NDIGIT [5S NEXT 
> QUOTIENT DIGIT AND HIGH DIVIDEND IS REMAINDER 


s “wae se 6B 


SUB A 7;CLEAR NUMBER OF TIMES INITIALLY 

LD (NDIGIT),A 

LD HL, (DSADR) 7;HL POINTS TQ DIVISOR 

LD DE, (HDEPTR) 7;DE POINTS TO CURRENT HIGH DIVIDEND 
LD BC, CQDEPTR) 7;BC POINTS TQ OTHER HIGH DIVIDEND 
LD A, (LENGTH) 

LD CCNTI,A ;LOQQP COUNTER = LENGTH 

OR A s;CLEAR CARRY INITIALLY 

LD A, (DE) ;GET NEXT BYTE OF DIVIDEND 

SBC A, (HL) 7;SUBTRACT DIVISOR 

DAA 7;CHANGE TO DECIMAL 

LD (BO),A 7;STORE DIFFERENCE IN OTHER DIVIDEND 
INC HL 7; INCREMENT TO NEXT BYTE 

INC DE 

INC BC 

LD A, (CNT) 7;DECREMENT COUNTER 

DEC A 

LD CCNT),A 

JR NZ, INNER sCONTINUE THROUGH ALL BYTES 

JR C, DVLOOP 7JUIMP WHEN BORROW OCCURS 


?NDIGIT IS NUMBER OF TIMES DIVISOR 
; GOES INTO ORIGINAL HIGH DIVIDEND 
sHIGH DIVIDEND CONTAINS REMAINDER 
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OQKEXIT: 


EREXIT: 


RLARY: 


LENGTH 
NDIGIT 
CNT: 

DVADR: 
DSADR: 
HDEPTR: 
QDEPTR: 


DIFFERENCE IS NOT NEGATIVE, SO ADD 1 TO 
NUMBER OF SUCCESSFUL SUBTRACTIONS 
(LOW DIGIT OF NDIGIT) 
LD HL, NDIGIT s;NDIGIT = NDIGIT + 1 
INC | CHL 


we “8 6wB 


s;EXCHANGE POINTERS, THUS MAKING DIFFERENCE NEW DIVIDEND 
LD HL, CHDEPTR) 


LD DE, (ODEPTR) 
LD CHDEPTR) , DE 
LD CODEPTR), HL 
JR SUBLP FCONTINUE UNTIL DIFFERENCE NEGATIVE 


7NO ERRORS, CLEAR CARRY 


OR A 7;CLEAR CARRY, VALID RESULT 
RET 


7;DIVIDE-BY-ZERO ERROR, SET CARRY 


SCF 7;SET CARRY, INVALID RESULT 
RET 


| RNHRHHKKHKRKHRHRRKRRRRRRKKKRERKE RAKE R 
7 SUBROUTINE: RLARY 


; PURPOSE: ROTATE LEFT AN ARRAY GONE DIGIT (4 BITS) 
s;ENTRY: HL = BASE ADDRESS OF ARRAY 
; LOW DIGIT OF NDIGIT IS DIGIT TO ROTATE THROUGH 


s;EXIT: ARRAY ROTATED LEFT THROUGH LOW DIGIT OF NDIGIT 
s;REGISTERS USED: AF, BC, DE, HL 
© SE HE E HE HE HE HE HE HE HE HE IE EE SE HE SE BE aE EE HE HE HE IE IE HE HE EE EE 


;SHIFT NDIGIT INTQ LOW DIGIT OF ARRAY AND 
; SHIFT ARRAY LEFT 


LD A, (LENGTH) 

LD B,A 3;B = LENGTH OF ARRAY IN BYTES 

LD A, (NDIGIT) 7A = NDIGIT 

RLD ?SHIFT BYTE LEFT 1 DIGIT ¢4 BITS) 
INC HL 

DJN SHIFT FCONTINUE UNTIL ALL BYTES SHIFTED 
LD (NDIGIT),A ;SAVE NEW NEXT DIGIT 

RET 

7 DATA 

DS i LENGTH OF ARRAYS IN BYTES 

DS 1 s;NEXT DIGIT IN ARRAY 

DS 1 ;COUNTER FOR SUBTRACT LOOP 

DS 2 s;DIVIDEND ADDRESS 

DS 2 ;DIVISOR ADDRESS 

DS 2 3HIGH DIVIDEND POINTER 

DS 2 sOTHER DIVIDEND POINTER 


6L MULTIPLE-PRECISION DECIMAL DIVISION (MPDDIV) 265 


COUNT: DS 2 s;DIVIDE LOOP COUNTER 
HIDE1: DS 255 s;HIGH DIVIDEND BUFFER 1 
HIDE2: ODS 255 ;HIGH DIVIDEND BUFFER 2 


SAMPLE EXECUTION: 


Ct ee ee i 
=e 6we8 WEB MS WE 


SC4L: 
LD HL, AY1 sBASE ADDRESS OF DIVIDEND 
LD DE, AY2 sBASE ADDRESS OF DIVISOR 
LD B,SZAYS sLENGTH OF ARRAYS IN BYTES 
CALL MPDDIV sMULTIPLE-PRECISION BCD DIVISION 
sRESULT OF 1522756 / 1234 = 1234 
s IN MEMORY AY1 = 34H 
; AY1i+1 = 12H 
H AY1+2 = OOH 
; AY1+3 = OOH 
H AY1+4 = OOH 
; AY1+5 = OOH 
1 AY1+6 = OOH 
JR SCé6L 
SZAYS EQu 7 sLENGTH OF ARRAYS IN BYTES 
AY1: 
DB OS6H 
DB 027H 
DB OS2H 
DB O1H 
DB 0 
DB Q 
DB QO 
AY=: 
DB O34H 
DB O12H 
DB 0 
DB CQ) 
DB 1) 
DEB 0 
DB Q 


END 


Multiple-Precision Decimal Comparison 


Compares two multi-byte unsigned decimal 
(BCD) numbers and sets the Carry and Zero 
flags appropriately. The Zero flag is set to 1 if the 
operands are equal and to 0 if they are not equal. 
The Carry flag is set to 1 if the subtrahend is 
larger than the minuend; the Carry flag is 
cleared otherwise. Thus the flags are set as if the 


Examples 


I. Data: Length of operands (in bytes) = 6 
Subtrahend = 196528719340, 


Minuend = 4567801532661¢ 


Result: Zero flag = 0 (operands are not equal) 


Carry flag = 0 (subtrahend is not larger than 


minuend) 


2. Data: Length of operands (in bytes) = 6 
Subtrahend = 196528719340, 


Minuend = 1965287193401, 


Result: Zero flag = 1 (operands are equal) 


Carry flag = 0 (subtrahend is not larger than 


minuend) 
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subtrahend had been subtracted from the 
minuend. 

Note: This program is exactly the same as 
Subroutine 6H, the multiple-precision binary 
comparison, since the form of the operands does 
not matter if they are only being compared. See 
Subroutine 6H for a listing and other details. 


3. Data: Length of operands (in bytes) = 6 
Subtrahend = 196528719340), 
Minuend = 0737859910741, 
Result: Zero flag = 0 (operands are not equal) 


Carry flag= 1 (subtrahend is larger than 
minuend) 


Bit Field Extraction (BFE) 


Extracts a field of bits from a byte and 
returns the field in the least significant bit posi- 
tions. The width of the field and its lowest bit 
position are parameters. 

Procedure: The program obtains a mask with 
the specified number of | bits from a table, shifts 


Registers Used: AF, BC, DE, HL 


Execution Time: 21 * LOWEST BIT POSITION 
plus 86 cycles overhead. (The lowest bit position 
determines the number of times the mask must be 
shifted left and the bit field mght.) 


Program Size: 32 bytes 


Data Memory Required: None 
Special Cases: 


1. Requesting a field that would extend beyond 
the end of the byte causes the program to return with 
only the bits through bit 7. That is, no wraparound is 
provided. If, for example, the user asks for a 6-bit 


Entry Conditions 


Starting (lowest) bit position in the field 
(Oto 7)inA 

Number of bits in the field (1 to 8) in D 

Data byte in E 


Examples 


1. Data: Data value= F6,,= 11110110, 
Lowest bit position = 4 


Number of bits in the field = 3 


Bit field = 07,¢ = 00000111, 
Three bits, starting at bit 4, have been ex- 
tracted (that is, bits 4 through 6). 


Result: 


7A 


the mask left to align it with the specified lowest 
bit position, and obtains the field by logically 
ANDing the mask with the data. It then normal- 
izes the bit field by shifting it right so that it 
starts in bit 0. 


field starting at bit 5, the program will return only 3 
bits (bits 5 through 7). 


2. Both the lowest bit position and the number of 
bits in the field are interpreted mod 8. That is, for 
example, bit position 11 is equivalent to bit position 3 
and a field of 10 bits is equivalent to a field of 2 bits. 
Note, however, that the number of bits in the field is 
interpreted in the range | to 8. That is, a field of 16 
bits is equivalent to a field of 8 bits, not toa field of 0 
bits. 


3. Requesting a field of width 0 causes a return 
with a result of 0. 





Exit Conditions 


Bit field in A (normalized to bit 0) 


2. Data: Data value= A2), = 10100010, 
Lowest bit position = 6 
Number of bits in the field = 5 
Result: _—_ Bit field = 02), = 00000010, 


Two bits, starting at bit 6, have been ex- 
tracted (that is, bits 6 and 7); that was all 
that was available, although five bits were 
requested. 
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Title Bit Field Extraction 
Name: BFE 
Purposes Extract a field of bits from a byte and 


return the field normalized to bit 90 

NOTE: IF THE REQUESTED FIELD IS TOO LONG, THEN 
ONLY THE BITS THROUGH BIT 7 WILL BE 
RETURNED. FOR EXAMPLE, IF A 4-BIT FIELD [5 
REQUESTED STARTING AT BIT 7, ONLY 1 
BIT (BIT 7) WILL BE RETURNED. 


Number of bits in field (1 to 8) 
Data byte 

Starting Clowest) bit position in 
the field (0 ta 7) 


Entrys Register D 
Register E 
Register A 


as “S$ “6 “Ss ws “EG US SS WH WE NE NE NE ONS 


Exits Register A = Field 
Registers used: AF,BC, DE, HL 
Times S86 cycles overhead plus 


(21 # lawest bit positian) cycles 


Size: Program 32 bytes 


A BY eT et ee ee et | ee ee | ey ee) ee Be BT 


ee ee ee ye | 


BFE: 
SHIFT DATA TQ NORMALIZE TO BIT 0 
> NO SHIFTING NEEDED IF LOWEST POSITION IS 0 
AND O0000111B sQNLY ALLOW POSITIONS 0 Ta 7 
JR Z,EXTR sJUMP IF NQ SHIFTING NEEDED 
LD B,A sMOVE SHIFT COUNT TC B 

SHFT: 
SRL E SHIFT DATA RIGHT 
DUNZ SHFT sCONTINUE UNTIL NORMALIZED 
sEXTRACT FIELD BY MASKING WITH 1°S 

EXTRs 
LD A,D *TEST NUMBER OF BITS FOR ZERO 
OR A 
RET Zz sEXIT IF NUMBER OF BITS = 0 


; FIELD IS 0 ON EXIT 


DEC A 7;DECREMENT A TO NORMALIZE TO 0 
AND OOOOO11LIE sONLY ALLOW O THROUGH 7 

LD C,A 3;BC = INDEX INTO MASK ARRAY 

LD B,Q 

LD HL, MSKARY s;HL = BASE OF MASK ARRAY 

ADD HL, BC 
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LD A,E ;GET DATA 

AND CHL) ;MASK OFF UNWANTED BITS 

RET 

s;MASK ARRAY WITH 1 TO 8 QNE BITS 
MSKARY : 

DB OO000001B 

DB 00000011B 

DB 00000111B 

DB 00001111B 

DB O0011111B 

DB OO1LLLI11B 

DB OLLLIL111B 

DB 111111116 


SAMPLE EXECUTION: 


“us U8 we WHR UE 
“ues “8 “6 wS “8 


SC7A: 
LD E,00011000B ;REGISTER E = DATA 
LD 0,3 ;REGISTER D = NUMBER OF BITS 
LD A,2 FACCUMULATOR = LOWEST BIT POSITION 
CALL. BFE ,EXTRACT 3 BITS STARTING WITH #2 
JR SC7A ; RESULT = 00000110B 


END 


Bit Field Insertion (6°!) 


Inserts a field of bits into a byte. The width of 
the field and its starting (lowest) bit position are 
parameters. 

Procedure: The program obtains a mask with 
the specified number of 0 bits from a table. It 
then shifts the mask and the bit field left to align 


Registers Used: AF, BC, DE, HL 
Execution Time: 25 * LOWEST BIT POSITION 
plus 133 cycles overhead. (The lowest bit position of 
the field determines how many times the mask and 
the field must be shifted left.) 
Program Size: 40 bytes 
Data Memory Required: None 
Special Cases: 

1. Attempting to insert a field that would extend 


beyond the end of the byte causes the program to 
insert only the bits through bit 7. That is, no wrap- 


Entry Conditions 


Data in A 

Number of bits in the field (1 to 8) in B 
Starting (lowest) bit position of field in C 
Field to insert in E 


Examples 


I. Data: Value = F6,¢ = 11110110, 
Lowest bit position = 4 
Number of bits in the field = 2 


Bit field = 01,¢ = 00000001, 

Value with bit field inserted = 
D646 — 11010110, 

The 2-bit field has been inserted into the origi- 
nal value starting at bit 4 (into bits 4 and 5). 


Result: 
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them with the specified lowest bit position. It 
logically ANDs the mask with the original data 
byte, thus clearing the required bit positions, 
and then logically ORs the result with the shifted 
bit field. 


around is provided. If, for example, the user attempts 
to insert a 6-bit field starting at bit 4, only 4 bits (bits 4 
through 7) are actually replaced. 


2. Both the starting bit position and the width of 
the bit field (number of bits) are interpreted mod 8. 
That is, for example, bit position 11 is the same as bit 


position 3 and a 12-bit field is the same as a 4-bit field. 
Note, however, that the width of the field is mapped 
into the range | to 8. That is, for example, a 16-bit 
field is the same as an 8-bit field. 


3. Attempting to insert a field of width 0 causes a 
return with a result of 0. 





Exit Conditions 


Result in A 
The result is the original data with the bit field 
inserted, starting at the specified bit position. 


2. Data: Value = B8,, = 10111000, 
Lowest bit position = | 
Number of bits in the field = 5 
Bit field = 15,, = 00010101, 
Result: Value with bit field inserted = AA,,=10101010, 


The 5-bit field has been inserted into the origi- 
nal value starting at bit 1 (into bits 1 through 
5), changing 11100, (1Cj¢) to 10101, (15,¢). 
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Title Bit Field Insertion 

Name: BFI 

Purpose: Insert a field of bits into a byte and return 
the byte 


NOTE: IF THE REQUESTED FIELD IS TOO LONG, 
ONLY THE BITS THROUGH BIT 7 WILL BE 
INSERTED. FOR EXAMPLE, IF A 4-BIT FIELD IS 
TO BE INSERTED STARTING AT BIT 7 THEN 
ONLY 1 BIT (BIT 7) WILL BE INSERTED. 


Entry: Register A = Byte of data 

Register B = Number of bits in the field (1 
to 8) 
Starting (lowest) bit position in 
which the data will be inserted 
(O toa 7) 
Register E = Field to insert 


Register C 


Exits Register A = Data 
Registers used: AF,BC, DE, HL 


Time: 133 cycles overhead plus 
(25 *% starting bit position) cycles 


a | | ee et ee et eo 
bt | i Mt et ee, et et Et et i) et ee) | et i) | ee eT 


Size: Program 40 bytes 
BFI: | 
PUSH AF »SAVE DATA BYTE 
sGET MASK WITH REQUIRED NUMBER OF O BITS 
PUSH BC :SAVE STARTING BIT POSITION 
LD HL, MSKARY 
LD A,B :GET NUMBER OF BITS 
AND A sTEST NUMBER OF BITS FOR O 
RET Z sRETURN WITH O RESULT IF NUMBER 
: OF BITS IS 0 
DEC A sNORMALIZE TO 0...7 
AND 00000111B sQNLY ALLOW 0...7 
LD C,A 
LD B,O 
AnD HL, BC s INDEX INTO MASK ARRAY 
LD D, CHL) 7D = MASK WITH ZEROS FOR CLEARING 
POP BC sRESTORE STARTING BIT 


7;TEST IF STARTING BIT IS 0 
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SFIELD: 


INSRT: 


—ws “8S wu USK OE 


SC7B: 


LD A4,C 
AND 00000111B sRESTRICT STARTING BIT TO 0...7 
JR Z, INSRT ;JUMP IF STARTING BIT IS 0 


; NO ALIGNMENT IS NECESSARY 


7;ALIGN FIELD TO INSERT AND MASK IF STARTING BIT NON-ZERO 


LD B,C 7B = STARTING BIT NUMBER 
LD A,D 7A = MASK 

SLA E ;SHIFT FIELD LEFT TO INSERT 
RLCA 7;ROTATE MASK 

DUINZ SFIELD 7;CONTINUE UNTIL ALIGNED 
LD 0,A 

7; INSERT FIELD 

POP AF 7;GET DATA BACK 

AND D 7;AND OFF MASK AREA 

OR E 7;QR IN FIELD 

RET 

7;MASK ARRAY ~- 1 TQ 8 ZERO BITS 

DB LL1IL1L110B 

DB {11111008 

DB 11111000B 

DB 1111Q0000B 

DB 11 100000B 

DB 11000000B 

DB 10000000B 

DB 00000000B 


SAMPLE EXECUTION: 


LD A,LILIL1IL1B 7;REGISTER A = DATA 

LD B,3 7;REGISTER B = NUMBER OF BITS 

LD C,2 7;REGISTER C = LOWEST BIT POSITION 
LD E, 900001018 ;REGISTER E = FIELD TO INSERT 
CALL BF I 7; INSERT 3-BIT FIELD STARTING AT 
JR SC7B ; BIT 2, RESULT = 111101116 


END 
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Multiple-Precision Arithmetic Shift Right 


(MPASR) 


Shifts a multi-byte operand right arithmeti- 
cally by a specified number of bit positions. The 
length of the operand (in bytes) is 255 or less. 
The Carry flag is set from the last bit shifted out 
of the rightmost bit position. The operand is 
stored with its least significant byte at the lowest 
address. 

Procedure: The program obtains the sign bit 
from the most significant byte, saves that bit in 
the Carry, and then rotates the entire operand 
right one bit, starting with the most significant 
byte. It repeats the operation for the specified 
number of shifts. 


Entry Conditions 


Base address of operand in HL 
Length of the operand in bytes in B 
Number of shifts (bit positions) in C 


Examples 


1. Data: Length of operand (in bytes) = 08 
Operand = 85A4C719FE06741 Ej¢ 


Number of shifts = 04 


Shifted operand = F85A4C719FE06741 |< 

This is the original operand shifted right four 
bits arithmetically; the four most signifi- 
cant bits all take the value of the original 
sign bit (1). 

Carry = I, since the last bit shifted from the 
rightmost bit position was 1. 


Result: 


TS 


Registers Used: AF, BC, DE, HL 


Execution Time: NUMBER OF SHIFTS * (46+ 
34 * LENGTH OF OPERANDS IN BYTES) + 
59 cycles 


Program Size: 28 bytes 
Data Memory Required: None 
Special Cases: 


1. If the length of the operand is 0, the program 
exits immediately with the operand unchanged and 
the Carry flag cleared. 


2. If the number of shifts is 0, the program exits 
immediately with the operand unchanged and the 
Carry flag cleared. 





Exit Conditions 


Operand shifted right arithmetically by the spec- 
ified number of bit positions. The original sign 
bit is extended to the right. The Carry flag is set 
from the last bit shifted out of the rightmost bit 
position. Carry is cleared if either the number 
of shifts or the length of the operand is 0. 


2. Data: Length of operand (in bytes) = 04 
Operand = 3F6A42D3)¢ 
Number of shifts = 03 
Result: Shifted operand = 07ED485A)¢ 


This is the original operand shifted right three 
bits arithmetically; the three most signifi- 
cant bits all take the value of the original 
sign bit (0). 

Carry = 0, since the last bit shifted from the 
rightmost bit position was 0. 
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Title Multiple-Precision Arithmetic Shift Right 

Name: MPASR 

Purposes Arithmetic shift right a multi-byte operand 
N bits 

Entry: Register pair HL = Base address of operand 


Register B = Length of operand in bytes 
Register C = Number of bits ta shift 


The operand is stored with ARRAYCO] as its 
least significant byte and ARRAYCLENGTH-1] 
its most significant byte, where ARRAY 

is its base address. 


Exits Operand shifted right with the most significant 
bit propagated. 
CARRY := Last bit shifted from least 
significant position. 
Registers used: AF,BC, DE,HL 


Time: 239 cycles overhead plus 
€(34 #* length) + 46) cycles per shift 


Size: Program 28 bytes 


=e ~s ~e “ws ws ws “SH wh WS WH wR NS NSB UNS UNH UME NS NR UNH NER UNE UNS UWS URE UNH NS 


MPASR: 
sEXIT IF NUMBER OF SHIFTS QR LENGTH OF OPERAND [5 0 
7;OR CLEARS CARRY IN EITHER CASE 


LD A,C 

OR A 

RET Z sRETURN IF NUMBER OF SHIFTS IS 0 
LD A,B 

OR A 

RET Z s;RETURN IF LENGTH OF OPERANT IS 0 
7;CALCULATE ADDRESS OF MOST SIGNIFICANT (LAST) BYTE 

LD E,B ;ADDRESS OF MSB = BASE + LENGTH-1 
LD 0,9 

ADD HL, DE 

DEC HL L = ADDRESS OF MSB 


H 

C = NUMBER OF SHIFTS 

A = LENGTH OF OFPERAND 

;LOOP ON NUMBER OF SHIFTS TO PERFORM 

sINITIAL CARRY = MOST SIGNIFICANT BIT OF ENTIRE OPERAND 


ws “se “68 
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LOOP: 
LD B, CHL) s;GET MOST SIGNIFICANT BYTE 
RL B sCARRY = MQST SIGNIFICANT BIT 
LD B,A 
LD E,L ;SAVE ADDRESS OF MSB 
LD D,H 
sROTATE BYTES RIGHT STARTING WITH MOST SIGNIFICANT 
ASRLP s 
RR CHL) sROTATE A BYTE RIGHT 
DEC HL. ;DECREMENT TO LESS SIGNIFICANT BYTE 
DAINZ ASRLP 
CONT =: 
LD L,E ;RESTORE ADDRESS OF MSB 
LD H,D 
DEC Cc ;DECREMENT NLIMBER OF SHIFTS 
JR NZ, LOOP 
RET 
; SAMPLE EXECUTION: ; 
SC7ls 
LD HL, AY ;BASE ADDRESS OF OPERAND 
LD B, SZAY 7;LENGTH OF OQPERAND IN BYTES 
LD C,SHIFTS ;NUMBER OF SHIFTS 
CALL MPASR 3 SHIFT 
s;RESULT OF SHIFTING EDCBA9S8S7654321H, 4 BITS IS 
; FEDCBA9S765432H, C=0 
; IN MEMORY AY = 032H 
; AY+1 = OD4H 
? AY+2 = 0O76H 
; AY+3 = O93H 
; AY+4 = OBAH 
; AY+S = ODCH 
; AY+6 = OFEH 
IR $c7c 
;DATA SECTION 
SZAY EQU 7 LENGTH OF OPERAND IN BYTES 
SHIFTS Eau 4 s;NUMBER OF SHIFTS 
AY: DB 21H, 43H, 65H, 87H, OA9H, OCBH, OEDH 


END 


Multiple-Precision Logical Shift Left 


(MPLSL) 


Shifts a multi-byte operand left logically bya 
specified number of bit positions. The length of 
the operand (in bytes) is 255 or less. The Carry 
flag is set from the last bit shifted out of the 
leftmost bit position. The operand is stored with 
its least significant byte at the lowest address. 

Procedure: The program clears the Carry 
initially (to fill with a 0 bit) and then shifts the 
entire operand left one bit, starting with the least 
significant byte. It repeats the operation for the 
specified number of shifts. 


as 


Registers Used: AF, BC, DE 


Execution Time: NUMBER OF SHIFTS * (27+ 34+ 
LENGTH OF OPERAND IN BYTES)+ 31 cycles 


Program Size: 21 bytes 
Data Memory Required: None 
Special Cases: 


1. If the length of the operand is 0, the program 
exits immediately with the operand unchanged and 
the Carry flag cleared. 


2. If the number of shifts is 0, the program exits 
immediately with the operand unchanged and the 
Carry flag cleared. 








Entry Conditions 


Base address of operand in HL 
Length of operand in bytes in B 
Number of shifts (bit positions) in C 


Examples 


1. Data: Length of operand (in bytes) = 08 
Operand = 85A4C719FE06741 E4¢ 


Number of shifts = 04 


Shifted operand = 5A4C719FE06741 E0,,¢ 

This is the original operand shifted left four 
bits logically; the four least significant bits 
are all cleared. 

Carry = 0, since the last bit shifted from the 
leftmost bit position was 0. 


Result: 
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Exit Conditions 


Operand shifted left logically by the specified 
number of bit positions (the least significant bit 
positions are filled with 0’s). The Carry flag 1s set 
from the last bit shifted out of the leftmost bit 
position. Carry is cleared if either the number of 
shifts or the length of the operand is 0. 


2. Data: Length of operand (in bytes) = 04 
Operand = 3F6A42D3i¢ 
Number of shifts = 03 
Result: Shifted operand = FB521698j, 


This is the original operand shifted left three 
bits logically; the three least significant bits 
are all cleared. 

Carry = 1, since the last bit shifted from the 
leftmost bit position was 1. 


7D MULTIPLE-PRECISION LOGICAL SHIFT LEFT (MPLSL) 2297 
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Title Multiple-Precision Logical Shift Left 

Name: MPLSL 

Purposes Logical shift left a multi-byte operand ; 
N bits : 

Entrys Register pair HL = Base address of operand : 


Register B = Length of operand in bytes 
Register C = Number of bits ta shift 


The operand is stored with ARRAY(O] as its 
least significant byte and ARRAYCLENGTH-11] 
its most significant byte, where ARRAY 

is its base address. 


Exit: Operand shifted left filling the least 
significant bits with zeros 
CARRY := Last bit shifted from 
most significant position 


Registers used: AF,BC, DE 


le) ee eS | ey ee ee ee ee ee ee) | | | 


Time: Si cycles overhead plus 
((34 *® length) + 27) cycles per shift 


Size: Program 21 bytes 


“me we “8 “SB “SB WH UH ONS NB MR UR NR UNA NO Me NS NR ONS NBR UNS ONS 
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MPLSL: 
sEXIT IF NUMBER OF SHIFTS OR LENGTH OF OPERAND IS 0 
‘QR CLEARS CARRY IN EITHER CASE 
LD A,C 
OR A 
RET Z sRETURN IF NUMBER OF SHIFTS IS 0 
LOD A,B 
OR A 
RET Z sRETURN IF LENGTH OF OPERANT IS 0 
;LOQQP ON NUMBER OF SHIFTS TO PERFORM 
sA = LENGTH OF OQPERAND 
3;C = NUMBER OF SHIFTS 
sHL = ADDRESS OF LEAST SIGNIFICANT (FIRST) BYTE OF OPERAND 
sCARRY = O INITIALLY FOR LOGICAL SHIFT 
LOOP: 
LD EL sSAVE ADDRESS OF LSB 
LD D,H 
LD B,A °B = LENGTH OF OPERAND 
OR A CLEAR CARRY FOR LOGICAL SHIFT 
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7;ROTATE BYTES STARTING WITH LEAST SIGNIFICANT 


LSLLPs 
RL CHL) sROTATE NEXT BYTE LEFT 
INC HL s; INCREMENT TO MORE SIGNIFICANT BYTE 
DuUINZ LSLLP 
LD L,E ;RESTORE ADDRESS OF LSE 
LD H,D 
DEC Cc ;DECREMENT NUMBER OF SHIFTS 
JR NZ, LOOP 
RET 
? SAMPLE EXECUTION: 
ScC7D: 
LD HL, AY s;HL = BASE ADDRESS OF OPERAND 
LD B,SZAY 7B = LENGTH OF OPERAND IN BYTES 
LD C,SHIFTS 3;C = NUMBER OF SHIFTS 
CALL MPLSL 3; SHIFT 
;RESULT OF SHIFTING EDCBA9S7654321H, 4 BITS IS 
7 . DCBAYS76543210H, C=O 
; IN MEMORY AY = QO10H 
; AY+1 = O32H 
; AY+2 = O54H 
; AY+3 = 076H 
; AY+4 = O98H 
; AY+3 = OBAH 
; AY+6é = ODCH 
JR SC7D 
sDATA SECTION 
SZAY EQu 7 7;LENGTH OF OPERAND IN BYTES 
SHIFTS EaQU 4 7;NUMBER OF SHIFTS 
AY: DB 21H, 43H, 65H, 87H, OAH, OCBH, OEDH 


END 


=e we ws “WS ws 


Multiple-Precision Logical Shift Right 


(MPLSR) 


Shifts a multi-byte operand right logically by 
a specified number of bit positions. The length 
of the operand (in bytes) is 255 or less. The 
Carry flag is set from the last bit shifted out of 
the rightmost bit position. The operand is stored 
with its least significant byte at the lowest 
address. 

Procedure: The program clears the Carry 
initially (to fill with a O bit) and then shifts the 
entire operand right one bit, starting with the 
most significant byte. It repeats the operation 
for the specified number of shifts. 


Entry Conditions 


Base address of operand in HL 
Length of operand in bytes in B 
Number of shifts (bit positions) in C 


Examples 


1. Data: Length of the operand (in bytes) = 08 
Operand = 85A4C719FE06741Ej¢ 


Number of shifts = 04 


Shifted operand = 085A4C719FE06741 \¢ 

This is the original operand shifted right 
four bits logically; the four most significant 
bits are all cleared. 

Carry= 1, since the last bit shifted from the 
rightmost bit position was 1. 


Result: 


fac 


Registers Used: AF, BC, DE, HL 


Execution Time: NUMBEROF SHIFTS * (35 +34 « 
LENGTH OF OPERAND IN BYTES)-+ 59 cycles 


Program Size: 26 bytes 
Data Memory Required: None 
Special Cases: 


1. If the length of the operand is 0, the program 
exits immediately with the operand unchanged and 
the Carry flag cleared. 


2. If the number of shifts is 0, the program exits 
immediately with the operand unchanged and the 
Carry flag cleared. 





Exit Conditions 


Operand shifted right logically by the specified 
number of bit positions. (The most significant 
bit positions are filled with 0’s.) 

The Carry flag is set from the last bit shifted out 
of the rightmost bit position. Carry is cleared 
if either the number of shifts or the length of 
the operand is 0. 


2. Data: Length of operand (in bytes) = 04 
Operand = 3F6A42D3)j¢ 
Number of shifts = 03 
Result: Shifted operand = 07ED485A)¢ 


This is the original operand shifted right three 
bits logically; the three most significant bits 
are all cleared. 

Carry = 0, since the last bit shifted from the 
rightmost bit position was 0. 
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Title Multiple-Precisian Logical Shift Right 

Name: MPLSR 

Purposes Logical shift right a multi-byte operand N bits 
Entry: Register pair HL = Base address of operand 


Register B = Length of operand in bytes 
Register C = Number of bits to shift 


The operand is stored with ARRAYCO)] as its 
least significant byte and ARRAYCLENGTH-1] 
its mast significant byte, where ARRAY 

is its base address. 


Exits Operand shifted right filling the most 
significant bits with zeros 


CARRY := Last bit shifted from least 
Significant poasition 


Registers used: AF,BC,DE, HL 


Time: 5? cycles overhead plus 
((€34 ® length) + 35) cycles per shift 


Program 24 bytes 


“8 “es “a ws we we “es «we “we 4S NS VR YS WB NR NA we oes ue ws we we ws Ne Ne oe 
rw 
ae 


MPLSR: 
,;EXIT IF NUMBER OF SHIFTS OR LENGTH OF OPERAND IS 0 
7;OR CLEARS CARRY IN EITHER CASE 


LD 4,C 
OR A 
RET Z sRETURN IF NUMBER OF SHIFTS I5 0 
LD A,B 
OR A 
RET Z sRETURN IF LENGTH OF OPERANT IS 0 
;CALCULATE ADDRESS OF MOST SIGNIFICANT (LAST) BYTE 
LD E,B sADDRESS OF MSB = BASE + LENGTH~1 
LD D,o 
ADD HL, DE 
DEC HL 7;HL = ADDRESS OF MSB 
;C = NUMBER OF SHIFTS 


7A = LENGTH OF OPERAND 
;LOQP ON NUMBER OF SHIFTS TO PERFORM 
;START WITH CARRY = 0 FOR LOGICAL SHIFT 
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LOOF: 
OR A :CLEAR CARRY FOR LOGICAL SHIFT 
LD B,A ;B = LENGTH OF OFPERAND 
LD E,L sSAVE ADDRESS OF MSE 
LD D,H 
sROTATE BYTES STARTING WITH MOST SIGNIFICANT 
LSSRLF': 
RR CHL) sROTATE A BYTE RIGHT 
DEC HL sRECREMENT TO LESS SIGNIFICANT BYTE 
DWINZ LSRLP 
LD L,E sRESTORE ADDRESS OF MSB 
LD H,D 
DEC: Cc sDECREMENT NUMBER OF SHIFTS 
JR NZ, LOOP 
RET 
; SAMPLE EXECUTION: ; 
SC7E: 
LO HL, AY sHL = BASE ADDRESS OF OPERAND 
LO B, SZAY 7B = LENGTH OF QPERAND IN BYTES 
LO C,SHIFTS :C = NUMBER OF SHIFTS 
CALL MPLSR ; SHIFT 
sRESULT OF SHIFTING EDCBA98S746454321H, 4 BITS IS 
; OENCBASS7465432H, C= 
>; IN MEMORY AY = O32H 
; AY+1 = O34H 
; AY+2 = 0O76H 
; AY+3 = O9SH 
; AY+4 = OBAH 
; AY+S = ODCH 
; AY+& = QOEH 
IR SC7E 
sDATA SECTICN 
SZAY EQU 7 sLENGTH OF OPERAND IN BYTES 
SHIFTS EQ 4 sNUMBER OF SHIFTS 
AY: DB 21H, 43H, 63H, 87H, OAPH, OCBH, OEDH 


END 


Multiple-Precision Rotate Right (MPi<i°) 


Rotates a multi-byte operand right by a spec- 
ified number of bit positions as if the most signif- 
icant bit and least significant bit were connected. 
The length of the operand (in bytes) is 255 or 
less. The Carry flag is set from the last bit shifted 
out of the rightmost bit position. The operand is 
stored with its least significant byte at the lowest 
address. 

Procedure: The program shifts bit 0 of the 
least significant byte of the operand to the Carry 
flag and then rotates the entire operand right 
one bit, starting with the most significant byte. It 
repeats the operation for the specified number 
of rotates. 


Eniry Conditions 


Base address of operand in HL 
Length of operand in bytes in B 
Number of rotates (bit positions) in C 


Examples 


1. Data: Length of operand (in bytes) = 08 
Operand = 85A4C719FE06741 Ej¢ 


Number of rotates = 04 


Rotated operand = E85A4C719FE06741 j¢ 

This is the original operand rotated right four 
bits; the four most significant bits are equiv- 
alent to the original four least significant 
bits. 

Carry = 1, since the last bit shifted from the 
rightmost bit position was 1. 


Result: 
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Registers Used: AF, BC, DE, HL, IX 


Execution Time: NUMBER OF ROTATES * (58 + 
34 * LENGTH OF OPERAND IN BYTES) + 83 
cycles 


Program Size: 33 bytes 
Data Memory Required: None 
Special Cases: 


1. If the length of the operand is 0, the program 
exits immediately with the operand unchanged and 
the Carry flag cleared. 


2. If the number of rotates is 0, the program exits 
immediately with the operand unchanged and the 
Carry flag cleared. 





Exit Conditions 


Operand rotated right logically by the specified 
number of bit positions (the most significant bit 
positions are filled from the least significant bit 
positions). The Carry flag is set from the last bit 
shifted out of the rightmost bit position. Carry is 
cleared if either the number of rotates or the 
length of the operand is 0. 


2. Data: Length of operand (in bytes) = 04 
Operand = 3F6A42D3 46 
Number of rotates = 03 
Result: Rotated operand = 67ED485Aj¢ 


This is the original operand rotated right 
three bits; the three most significant bits are 
equivalent to the original three least signif- 
icant bits. 

Carry = 0, since the last bit shifted from the 
rightmost bit position was 0. 
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Title Multiple-Precisian Ratate Right 

Names: MPRR 

Purposes Rotate right a multi-byte operand N bits 

Entry: Register pair HL = Base address of aperand 
Register B = Length of aperand in bytes 
Register C = Number of bits ta rotate 


The operand is stared with ARRAY([O] as its 
least significant byte and ARRAYCILENGTH-1] 
its most significant byte, where ARRAY 

is its base address. 


Exits Qperand rotated right 
CARRY := Last bit shifted fram least 
significant position 


Registers used: AF,BC,DE,HL,IX 


Times 63 cycles overhead plus 
((34 ® length) + 38) cycles per ratate 


Sizes Program 23 bytes 


s;EXIT IF NUMBER OF ROTATES OR LENGTH OF OPERAND IS 0 
;OR CLEARS CARRY IN EITHER CASE 


LD A,C 

OR A 

RET Zz 7;RETURN IF NUMBER OF ROTATES IS 0 
LD A,B 

OR A 

RET Z 7;RETURN IF LENGTH OF OPERANT IS 0 


sCALCULATE ADDRESS OF MOST SIGNIFICANT (LAST) BYTE 
PUSH HL 


POP Ix s;IX POINTS TO LSB (FIRST BYTE) 
LD E,B ADDRESS OF MSB = BASE + LENGTH-1 
LD 0,0 

ADD HL, DE 

DEC HL 


HL POINTS TO MSB (LAST BYTE) 
C = NUMBER OF ROTATES 
7A = LENGTH OF OPERAND 
7;LOOQP ON NUMBER OF ROTATES TQ PERFORM 
7;CARRY = LEAST SIGNIFICANT BIT OF ENTIRE OGPERAND 
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LOCF : 


RRLF': 


ss “8 “S “4 wD 


SC7F: 


SZAY 
ROTATS 
AY: 


BIT MANIPULATIONS AND SHIFTS 
LO R, (IX+0) ;GET LSB 
RR B 7;CARRY = BIT O OF LSB 
Lo B,A 7& = LENGTH OF OPERAND IN BYTES 
LD EL 7;SAVE ADDRESS OF MSE 
Lo D,H 
;ROTATE BYTES RIGHT STARTING WITH MOST SIGNIFICANT 
RR CHL) s;RQOTATE A BYTE RIGHT 
DEC HL. ;DECREMENT TO LESS SIGNIFICANT BYTE 
DLINZ RRLP 
LO LE sRESTORE ADDRESS OF MSB 
LD H,D 
DEC c 7;DECREMENT NUMBER OF ROTATES 
IR NZ, LOOP 
RET 


SAMPLE EXECUTION: 


LO HL, AY sBASE ADDRESS OF OFERAND 
LD B,SZAY :LENGTH QF OPERANT IN BYTES 
LD C,ROTATS sNUMBER OF ROTATES 
CALL MPRR sROTATE 
sRESULT OF ROTATING EDCBA9S7654321H, 4 BITS IS 
. L1ENCBA?S87635432H, C=0 
> IN MEMORY AY = O32H 
; AY+1 = OF4H 
; AY+2 = 0O746H 
; AY+3 = O9S3H 
; AY+4 = OBAH 
s AY+S = ODCH 
; AY+6 = O1EH 
JR SC7F 
sDATA SECTION 
EQu 7 sLENGTH OF OPERAND IN BYTES 
EQU 4 sNUMBER OF ROTATES 
DR 21H, 43H, 63H, 87H, OAPH, OCBH, OEDH 


END 


ws vs “=8 ~wS we 


Multiple-Precision Rotate Leff (MPI<L) 


Rotates a multi-byte operand left by a speci- 
fied number of bit positions as if the most signif- 
icant bit and least significant bit were connected. 
The length of the operand (in bytes) is 255 or 
less. The Carry flag is set from the last bit shifted 
out of the leftmost bit position. The operand is 
stored with its least significant byte at the lowest 
address. 

Procedure: The program shifts bit 7 of the 
most significant byte of the operand to the 
Carry flag. It then rotates the entire operand left 
one bit, starting with the least significant byte. It 
repeats the operation for the specified number 
of rotates. 


Entry Conditions 


Base address of operand in HL 
Length of operand in bytes in B 
Number of rotates (bit positions) in C 


Examples 


1. Data: Length of operand (in bytes) = 08 
Operand = 85A4C719FE06741 Ej¢ 


Number of rotates = 04 


Rotated operand = 5A4C719FE06741 E8 i¢ 

This is the original operand rotated left four 
bits; the four least significant bits are equiv- 
alent to the original four most significant 
bits. 

Carry = 0, since the last bit shifted from the 
leftmost bit position was 0. 


Result: 


Ke 


Registers Used: AF, BC, DE, HL, IX 


Execution Time: NUMBER OF ROTATES #* (58 + 
34 * LENGTH OF OPERAND IN BYTES) + 104 
cycles 


Program Size: 35 bytes 
Data Memory Required: None 


Special Cases: 


1. If the length of the operand is 0, the program 
exits immediately with the operand unchanged and 
the Carry flag cleared. 


2. If the number of rotates is 0, the program exits 
immediately with the operand unchanged and the 
Carry flag cleared. 





Exit Conditions 


Operand rotated left the specified number of bit 
positions (the least significant bit positions are 
filled from the most significant bit positions). 
The Carry flag is set from the last bit shifted out 
of the leftmost bit position. Carry is cleared if 
either the number of rotates or the length of the 
operand is 0. 


2. Data: Length of operand (in bytes) = 04 
Operand = 3F6A42D3j¢ 
Number of rotates = 03 
Result: Rotated operand = FB521699,, 


This is the original operand rotated left three 
bits; the three least significant bits are equiv- 
alent to the original three most significant 
bits. 

Carry = I, since the last bit shifted from the 
leftmost bit position was 1. 
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MPRL: 


Title Multiple-Precision Rotate Left 

Name: MPRL 

Purposes: Retate left a multi-byte operand N bits 

Entry: Register pair HL = Base address of operand 
Register B = Length of operand in bytes 
Register €C = Number of bits toa rotate 


The operand is stored with ARRAY[O] as its 
least significant byte and ARRAYCLENGTH-1 1] 
its most significant byte, where ARRAY 

is its base address. 


Exit: Gperand rotated left 
CARRY := Last bit shifted from mast 
significant position 


Registers used: AF,EC,DE,HL, IX 


Time: 104 cycles overhead plus 
((34 ® length) + 38) cycles per rotate 


Size: Program 35 bytes 


s;EXIT IF NUMBER OF ROTATES OR LENGTH OF OPERAND IS 0 
;OR CLEARS CARRY IN EITHER CASE 


LD 4,C 

OR A 

RET Z sRETURN IF NUMBER OF ROTATES IS 0 
LD 4,8 

OR A 

RET Z ;RETURN IF LENGTH OF OPERAND IS 0 
;CALCULATE ADDRESS OF MOST SIGNIFICANT (LAST) BYTE 

PUSH HL. ;SAVE ADDRESS OF FIRST BYTE 

LD E,B s;ADDRESS OF MSB = BASE +LENGTH~1 

LD D,o 

ADD HL, DE 

DEC HL 

PLUSH HL. 

POP IX IX POINTS TO MOST SIGNIFICANT BYTE 
POP HL s;HL POINTS TO LEAST SIGNIFICANT BYTE 


7;C = NUMBER OF ROTATES 
7A = LENGTH OF OPERAND 
7;LOOP ON NUMBER OF ROTATES TO PERFORM 


ea «SBS 
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7;CARRY = MOST SIGNIFICANT BIT OF ENTIRE OQPERAND 


LOOP : 
Lo B, (IX+0) sGET MOST SIGNIFICANT BYTE 
RL B sCARRY = BIT 7 OF MSE 
LO B,A ;E = LENGTH OF OPERAND IN BYTES 
Lo Ey ‘SAVE ADDRESS OF LSB 
Lo C,H 
sROTATE BYTES LEFT STARTING WITH LEAST SIGNIFICANT 
RLLF': 
RL CHL) sROTATE A BYTE LEFT 
INC HL s INCREMENT TO MORE SIGNIFICANT BYTE 
DUNZ RLLP 
LO LE sRESTORE ADDRESS OF LSB 
LO H,D 
DEC Cc 3;DECREMENT NUMBER OF ROTATES 
AR NZ, LOOP 
RET 
; SAMPLE EXECUTION: ; 
SC7G: 
LO HL., AY sHL = BASE ADDRESS OF OFERAND 
LO B, SZAY sB = LENGTH GF OFERAND IN BYTES 
LO C,ROTATS 3C = NUMBER OF ROTATES 
CALL MFRL sROTATE 
sRESULT QF ROTATING EDCRA9S76954321H, 4 BITS IS 
; OCBASS7454321EH, C=0 
: IN MEMORY AY = OLEH 
; AY+1 = O32H 
; AY+2 = O54H 
; AY+3 = 0O76H 
; AY+4 = O9SH 
; AY+S = OBAH 
. AY+6 = ODCH 
JR SC76 
sDATA SECTION 
SZAY EQu 7 *LENGTH QF OQPERAND IN BYTES 
ROTATS EQU 4 s;NUMBER OF ROTATES — 
AY: DB 21H, 43H, 65H, 87H, OASH, OCBH, OE DH 


END 


String Compare (SIiCIVP) 


Compares two strings and sets the Carry and 
Zero flags appropriately. The Zero flag is set to 1 
if the strings are identical and to 0 otherwise. 
The Carry flag is set to 1 if the string with the 
base address in DE (string 2) is larger than the 
string with the base address in HL (string 1); the 
Carry flag is set to 0 otherwise. The strings area 
maximum of 255 bytes long and the actual 
characters are preceded by a byte containing the 
length. If the two strings are identical through 
the length of the shorter, the longer string is 
considered to be larger. 

Procedure: The program first determines which 
string is shorter from the lengths that precede 
the actual characters. It then compares the 
strings one byte at a time through the length of 
the shorter. The program exits with the flags set 
if it finds corresponding bytes that differ. If the 
strings are the same through the length of the 


Entry Conditions 


Base address of string 2 in DE 
Base address of string | in HL 
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SA 


Registers Used: AF BC, DE, HL 
Execution Time: 


1. If the strings are not identical through the 
length of the shorter, the time is 91 + 60 * NUMBER 
OF CHARACTERS COMPARED. If, for example, 
the routine compares five characters before finding a 
disparity, the execution time is 

91+ 60 * 5= 91+ 300= 391 cycles 


2. If the strings are identical through the length of 
the shorter, the time is 131 + 60 * LENGTH OF 
SHORTER STRING. If, for example, the shorter 
string is eight bytes long, the execution time is 

131 + 60 * 8= 131 + 480= 611 cycles 


Program Size: 32 bytes 


Data Memory Required: Two bytes anywhere in 
RAM for the lengths of the strings (addresses 
LENS! and LENS2). 


shorter, the program sets the flags by comparing 
the lengths. 


Exit Conditions 


Flags set as if string 2 had been subtracted from 
string |. If the strings are the same through 
the length of the shorter, the flags are set as if 
the length of string 2 had been subtracted 
from the length of string 1. 


Zero flag= 1 if strings are identical, 0 if they are 
not. 


Carry flag= 1 if string 2 is larger than string 1, 0 
if they are identical or string | is larger. If the 
strings are the same through the length of the 
shorter, the longer one is considered to be 
larger. 


Examples 
1. Data: String |= 05°PRINT? (05 is the length of the 
string) 
String 2 = 03‘END’ (03 is the length of the 
string) 
Result: Zero flag = 0 (strings are not identical) 
Carry flag = 0 (string 2 is not larger than 
string 1) 
2. Data: String 1 = 05°PRINT” (05 is the length of the 
string) 
String 2 = 02‘°PR’ (02 is the length of the 
string) 
Result: Zero flag = 0 (strings are not identical) 


Carry flag = 0 (string 2 is not larger than 
string 1) 


The longer string (string 1) is considered to be 
larger. If you want to determine whether string 2 
is an abbreviation of string 1, you could use 
Subroutine 8C (Find the Position of a Substring) 
and determine whether string 2 was part of 
string | and started at the first character. 

We are assuming here that the strings consist 
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Compare 2 strings and return C and Z flags set 


Title String compare 
Name: STRCMP 
Purposes 

or cleared 
Entrys Register pair HL 


Register pair DE 


A string is a maximum of 255 bytes long plus 
a length byte which precedes it. 
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3. Data: String | = 05‘PRINT? (05 is the length of the 
string) 
String 2 = 06‘SYSTEM’ (06 is the length of 
the string) 
Result: Zero flag = 0 (strings are not identical) 


Carry flag= | (string 2 is larger than string 1) 


of ASCII characters. Note that the byte preceding 
the actual characters contains a hexadecimal 
number (the length of the string), not a character. 
We have represented this byte as two hexadecimal 
digits in front of the string. The string itself is 
shown surrounded by single quotation marks. 
These serve only to delimit strings in the examples; 
they are not actually part of the data. This 
format is used to display string data in the 
examples throughout this chapter. 

This routine treats spaces like other charac- 
ters. If, for example, the strings are ASCII, the 
routine will find that SPRINGMAID is larger 
than SPRING MAID, since an ASCII M (4D je) 
is larger than an ASCII space (206). 


“ea 
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Base address of string 1 
Base address of string 2 


“eo ue “MG ~S ~S VR UR UNE UR UNE 
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Exits: IF string 1 = string 2 THEN 
Z=1,C=0 

IF string 1 > string 2 THEN 
Z=0,C=0 

IF string 1 < string 2 THEN 
Z=0,C=1 


Registers used: AF,BC,DE,HL 


Times 91 eyeles averhead plus 60 cycles per byte plus 
40 cycles if strings are identical 
through length of shorter 


Size: Program 32 bytes 
Data 2 bytes 
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STRCMP: 
sDETERMINE WHICH STRING IS SHORTER 
;LENGTH OF SHORTER = NUMBER OF BYTES TO COMPARE 
LD A, CHL) ;SAVE LENGTH OF STRING 1 
LD (LENS1),A 
LD A, (DE) 3SAVE LENGTH OF STRING 2 
LD (LENS2),A 
CP CHL) sCOMPARE TO LENGTH OF STRING 1 
JR C, BEGCMP 3JUMP IF STRING 2 IS SHORTER 
LD A, (HL) s;ELSE STRING 1 IS SHORTER 
3;COMPARE STRINGS THROUGH LENGTH OF SHORTER 
BEGCMP: 
OR A s;TEST LENGTH OF SHORTER STRING 
IR Z,CMPLEN ; COMPARE LENGTHS 
; IF LENGTH IS ZERO 
LD B,A 7B = NUMBER OF BYTES TO COMPARE 
EX DE, HL ;DE = STRING 1 
3;HL = STRING 2 
CMPLP: 
INC HL 7; INCREMENT TO NEXT BYTES 
INC DE 
LD A, (DE) 7;GET A BYTE OF STRING 1 
CP CHL) 7;COMPARE TO BYTE OF STRING 2 
RET NZ 7;RETURN WITH FLAGS SET IF BYTES 
; NOT EQUAL 
DJINZ CMPLP sCONTINUE THROUGH ALL BYTES 
?STRINGS SAME THROUGH LENGTH OF SHORTER 
7S0 USE LENGTHS TO SET FLAGS 
CMPLEN: LD A, (LENS1) 7COMPARE LENGTHS 
LD HL, LENS2 
CP CHL) 
RET ;RETURN WITH FLAGS SET OR CLEARED 
7DATA 
LENS1i: DS 1 7;LENGTH OF STRING 1 


LENS2: DS i ;LENGTH OF STRING 2 
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SAMPLE EXECUTION: 


LO HL, Si 
LD DE, S2 
CALL STRCMP 


JR SCSA 
DB 20H, “STRING 1 
DB 20H, “STRING 2 


END 
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7;BASE ADDRESS OF STRING 1 

;BASE ADDRESS OF STRING 2 

sCOMPARE STRINGS 

sCOMPARING "STRING 1" AND "STRING 2" 
; RESULTS IN STRING 1 LESS THAN 

; STRING 2, SO Z=0,C=1 


;LOOP FOR ANOTHER TEST 


7 
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String Concatenation (CONCA)) 


Combines (concatenates) two strings, placing 
the second immediately after the first in memory. 
If the concatenation produces a string longer 
than a specified maximum, the program con- 
catenates only enough of string 2 to give the 
combined string its maximum length. The Carry 
flag is cleared if all of string 2 can be concatenated 
or set to | if part of string 2 must be dropped. 
Both strings are a maximum of 255 bytes long 
and the actual characters are preceded bya byte 
containing the length. 

Procedure: The program uses the length of 


Registers Used: AF, BC, DE, HL 


Execution Time: Approximately 21 * NUMBER 
OF CHARACTERS CONCATENATED plus 288 
cycles overhead. NUMBER OF CHARACTERS 
CONCATENATED is normally the length of string 
2, but it will be the maximum length of string | minus 
its current length if the combined string would be too 
long. If, forexample, NUMBER OF CHARACTERS 


CONCATENATED is 14)¢ (209), the execution time 
1S 


21 * 20 + 288 = 420 + 288 = 708 cycles 
Program Size: 83 bytes 


Data Memory Required: Five bytes anywhere in 
RAM for the base address of string | (2 bytes starting 
at address SIADR), the lengths of the strings 
(addresses SILEN and S2LEN), and a flag that 


Entry Conditions 


Base address of string 2 in DE 
Base address of string 1 in HL 
Maximum length of string | in B 
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string 1 to determine where to start adding char- 
acters and the length of string 2 to determine how 
many characters to add. If the sum of the lengths 
exceeds the maximum, the program indicates an 
overflow and reduces the number of characters it 
must add (the number is the maximum length 
minus the length of string 1). It then moves the 
appropriate number of characters from string 2 
to the end of string 1, updates the length of string 
I, and sets the Carry flag to indicate whether any 
characters were discarded. 


indicates whether the combined strings overflowed 
(address STRGOV). 


Special Cases: 


1. If concatenating would make the string longer 
than its specified maximum length, the program 
concatenates only enough of string 2 to reach the 
maximum. If any of string 2 must be truncated, the 
Carry flag is set to 1. 


2. If string 2 has a length of 0, the program exits 
with the Carry flag cleared (no errors) and string 1 
unchanged. That is, a length of 0 for either string is 
interpreted as 0, not as 256. 


3. If the original length of string 1 exceeds the 
specified maximum, the program exits with the 
Carry flag set to | (indicating an error) and string | 
unchanged. 





Exit Conditions 


String 2 concatenated at the end of string 1 and 
the length of string | increased appropriately. If 
the resulting string would exceed the maximum 
length, only the part of string 2 that would give 
string | its maximum length is concatenated. If 
any part of string 2 must be dropped, the Carry 
flag is set to 1. Otherwise, the Carry flag is 
cleared. 


Examples 


1. Data: 


Result: 


Maximum length of string 1 = OE;, = 144 

String | = 07-JOHNSON’ (07 is the length of 
the string) 

String 2 = 05‘,DON’ (05 is the length of the 
string) 

String |= OC-JOHNSON, DON’ (0Ci¢= 1249 
is the length of the combined string with 
string 2 placed after string 1) 

Carry = 0, since the concatenation did not 
produce a string exceeding the maximum 
length. 


Note that we are representing the initial byte 
(containing the length of the string) as two 
hexadecimal digits in both examples. 


“ue =s8 “SG WS NE 6S UWS ONS 
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A string is a maximum af 255 bytes lang plus 
a length byte which precedes it. 
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2. Data: 


Result: 


strings inta one string 


Title String Concatenation 
Name: CONCAT 

Purpose: Concatenate 2 

Entry: Register pair HL = 
Exits String 1 := 


string 1 cancatenated with string 2 


If no errars then 


CARRY := 0 
else 
begin 


CARRY := 1 

if the concatenation makes string 1 tao 

concatenate only enough of string 2 

to give string 1 its maximum length. 

if length(stringl) > maximum length then 
no concatenatian is done 


long, 


end: 


Base address af string 1 
Register pair DE = Base address af string 2 
Register B = Maximum length of string i 


String | = 07‘JOHNSON’ (07 is the length of 
the string) 

String 2= 09°,RICHARD?’ (09 is the length of 
the string) 


String | = OE‘JOHNSON, RICHA’ (OEj, = 
14,9 is the maximum length allowed, so the 
last two characters of string 2 have been 
dropped) 

Carry = 1, since the concatenation produced 
a string longer than the maximum length. 
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STRING MANIPULATION 


CONCAT: 


TOOLN 


a 


Registers used: AF,BC, BE,HL 


Times Approximately 21 *® Clength of string 2) cycles 
Plus 288 cycles averhead 


Size: Pragram 83 bytes 
Data 5 bytes 


;DETERMINE WHERE TO START CONCATENATING 
7CONCATENATION STARTS AT THE END OF STRING 1 
;END OF STRING 1 = BASE1 + LENGTH! + 1, WHERE 

; THE EXTRA 1 MAKES UP FOR THE LENGTH BYTE 
s;NEW CHARACTERS COME FROM STRING 2, STARTING AT 
; BASE2 + 1 (SKIPPING QVER LENGTH BYTE) 


LD (S1LADR), HL ;SAVE ADDRESS OF STRING 1 

PUSH BC 7SAVE MAXIMUM LENGTH OF STRING 1 
LD A, (HL) s;SAVE LENGTH OF STRING 1 

LD (SILEN),A 

LD C,A 7;END1 = BASEL + LENGTH1 + 1 

LD B,O 

ADD HL, BC 

INC HL s;HL = START OF CONCATENATION 

LD A, (DE) 7;SAVE LENGTH OF STRING 2 

LD (S2LEN),A 

INC DE ;DE = FIRST CHARACTER OF STRING 2 
POP BC s;RESTORE MAXIMUM LENGTH 
;DETERMINE HOW MANY CHARACTERS TO CONCATENATE 

LD C,A ;ADD LENGTHS OF STRINGS 

LOD A, (SILEN) 

ADD A,C 

JR C, TOOLNG sJUMP IF SUM EXCEEDS 255 

CP B ;COMPARE TQ MAXIMUM LENGTH 

IR Z,LENOK ;JUMP IF NEW STRING IS MAX LENGTH 
JR C,LENOK ; OR LESS 


COMBINED STRING IS TOO LONG 

INDICATE A STRING OVERFLOW, STRGOV := OFFH 

NUMBER OF CHARACTERS TO CONCATENATE = MAXLEN - SILEN 
LENGTH OF STRING 1 = MAXIMUM LENGTH 


aao6“s “8 “SO 


LD A, OFFH 


s INDICATE STRING OVERFLOW 
LD (STRGOV),A 
LD A, (SILEN) sCALCULATE MAXLEN - S1LEN 
LD C,A 
LD A,B 
SUB C 
RET Cc sEXIT IF ORIGINAL STRING TOO LONG 
LD (S2LEN),A ;CHANGE S2LEN TO MAXLEN - SILEN 
LD A,B ;LENGTH OF STRING 1 = MAXIMUM 
LD (SILEN),A 


JR DOCAT ;PERFORM CONCATENATION 


=a owe we we “8 WHA WS “SES WE 


LENOQK s 


DOCAT: 


EXIT: 


S1IADR: 
SILEN: 
S2LEN: 
STRGOV: 


=e “8 48 wS <S 


SCSB: 


if) 
~~ 
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;RESULTING LENGTH DOES NOT EXCEED MAXIMUM 

; LENGTH OF STRING 1 = SILEN + S2LEN 

; INDICATE NO OVERFLOW, STRGOV := 0 

; NUMBER OF CHARACTERS TQ CONCATENATE = LENGTH OF STRING 2 


LD (SILEN),A 7;SAVE SUM OF LENGTHS 
SUB A ; INDICATE NO OVERFLOW 
LO (STRGOV),A 


7;CONCATENATE STRINGS BY MOVING CHARACTERS FROM STRING 2 
; TO END OF STRING 1 


LD A, (S2LEN) 7;GET NUMBER OF CHARACTERS 
QR A 
JR Z,EXIT ,EXIT IF NOTHING TQ CONCATENATE 
LD C,A 7;BC = NUMBER OF CHARACTERS 
LD B,O 
EX DE, HL 7;DE = DESTINATION 
7;HL = SOURCE 
LDIR 7MOQVE CHARACTERS 
LD A, (SILEN) 7;ESTABLISH NEW LENGTH OF STRING 1 
LD HL, (SiADR) 
LO (HLD,A 
Bos A, (STRGOV) ;CARRY = 1 IF OVERFLOW, O IF NOT 
RET 
7 DATA 
DS 2 ;BASE ADDRESS OF STRING 1 
DS 1 7;LENGTH OF STRING 1 
DS i ;LENGTH OF STRING 2 
DS 1 7STRING OVERFLOW FLAG 


SAMPLE EXECUTION: 


=s VE NS UE WE 


LD HL,S1 7;HL = BASE ADDRESS OF S31 

LD DE, S2 7;DE = BASE ADDRESS OF S2 

LD R, 20H 7B = MAXIMUM LENGTH OF STRING 1 
CALL CONCAT sCONCATENATE STRINGS 

JR SCSB s;RESULT OF CONCATENATING 


7 “LASTNAME" AND ", FIRSTNAME" 
7; IS $1 = 13H, "LASTNAME, FIRSTNAME"™ 


7TEST DATA, CHANGE FOR OTHER VALUES 
DB 8H 7;LENGTH OF S31 
DB “LASTNAME “ 332 BYTE MAX LENGTH 
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$2: DB OBH s;LENGTH OF S2 
DB *, FIRSTNAME “ 332 BYTE MAX LENGTH 


END 


Find the Position of a Substring (POS) 


Searches for the first occurrence of a substring 
within a string. Returns the index at which the 
substring starts if it is found and 0 if it is not 
found. The string and the substring are both a 
maximum of 255 bytes long, and the actual 
characters are preceded by a byte containing the 
length. Thus, if the substring is found, its starting 
index cannot be less than | or more than 255. 


Registers Used: AF, BC, DE, HL 


Execution Time: Data-dependent, but the overhead 
is 157 cycles, each successful match of | character 
takes 56 cycles, and each unsuccessful match of 1 
character takes 148 cycles. The worst case is when the 
string and substring always match except for the last 
character in the substring, such as 
String = ‘AAAAAAAAB’ 
Substring = ‘AAB’ 
The execution time in that case is 
(STRING LENGTH — SUBSTRING LENGTH 
+ 1) * (56 * (SUBSTRING LENGTH — 1) + 
148) + 154 
If, for example, STRING LENGTH = 9 and SUB- 
STRING LENGTH = 3 (as in the case shown), the 
execution time is 
(9—3+ 1) *(56*(3— 1)+ 148)+ 154= 7 * 260+ 
154= 1820+ 154 = 1974 cycles 


Program Size: 69 bytes 


Data Memory Required: Seven bytes anywhere in 
RAM for the base address of the string (2 bytes 


Entry Conditions 


Base address of substring in DE 
Base address of string in HL 


8C 


Procedure: The program searches the string 
for the substring until either it finds the substring 
or the remaining part of the string is shorter 
than the substring and hence cannot possibly 
contain it. If the substring is not in the string, the 
program clears the accumulator; otherwise, the 
program places the starting index of the substring 
in the accumulator. 


starting at address STRING), the base address of the 
substring (2 bytes starting at address SUBSTG), the 
length of the string (address SLEN), the length of the 
substring (address SUBLEN), and the current starting 
index in the string (address INDEX). 


Special Cases: 


1. If either the string or the substring has a length 
of 0, the program exits with 0 in the accumulator, 
indicating that it did not find the substring. 


2. If the substring is longer than the string, the 


program exits with 0 in the accumulator, indicating 
that it did not find the substring. 


3. If the program returns an index of |, the 
substring may be regarded as an abbreviation of the 
string. That is, the substring occurs in the string, 
starting at the first character. A typical example 
would be a string PRINT and a substring PR. 


4. If the substring occurs more than once in the 
string, the program will return only the index to the 
first occurrence (the occurrence with the lowest 
starting index). 





Exif Conditions 


A contains index at which first occurrence of 
substring starts if it is found and contains 0 if 
substring is not found. 
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Examples 


1. Data: 


Result: 


2. Data: 


Result: 


“us ws wea “ws 4S WS NH NE 


we “6 “8 ~S 64S 


=weo06~S 6S WS NS UNS USS UNS NS NS UNE NE ONS SE ONE 


Entrys 


String = 1D‘'ENTER SPEED IN MILES 
PER HOUR’ (1Dj¢ = 2919 is the length of 
the string) 

Substring = 05‘MILES’ (05 is the length of 
the substring) 


A contains 10¢ (16)9), the index at which the 
substring ‘MILES’ starts. 


String = 1BSSALES FIGURES FOR JUNE 

1981°(1B,¢= 27 9 is the length of the string) 

Substring = 04‘JUNE’ (04 is the length of the 
substring) 


A contains 13¢ (19j9), the index at which the 
substring ‘JUNE’ starts. 


Title 


Name: Fas 


Purposes: 


A string is a maximum of 255 bytes long plus 
a length byte which precedes it. 


Exits: 


Register A = 


else 


Register A = 0 


Registers used: AF,BC,DE,HL 


Times 


3: 


4. 


Register pair HL 
Register pair DE 


Data: 


Result: 


Data: 


Result: 


Find the position of a substring in a string 


Search for the first occurrence of a substring 
within a string and return its starting index. 
If the substring is nat found a 0 is returned. 


= Base address of string 
= Base address of substring 


If the substring is found then 
its starting index 


Since the algorithm is so data-dependent, 


String= 10°LET Y1= X1+ R7’(10)¢= 16,9 is 
the length of the string) 

Substring = 02‘R4’ (02 is the length of the 
substring) 


A contains 0, since the substring ‘R4’ does not 
appear in the string LET YI = X1 + R7. 


String = 07‘RESTORE’ (07 is the length of 
the string) 

Substring = 03‘RES’ (03 is the length of the 
substring) 


A contains |, the index at which the substring 
‘RES’ starts. An index of | indicates that 
the substring could be an abbreviation of 
the string. Interactive programs, such as 
BASIC intepreters and word processors, 
often use such abbreviations to save on 
typing and storage. 


“ws “8 ws “Ss “A “ES WS “ES 


ws “6 ws ws ws “8 ws ws “SH hE we WS OMS NS WER US UNE UNS UE OS 


“=e “6 “8 ~S ww “SS “SES NE WS NS SR NES UNE UNS NS NE UNE NE OE 


Pass: 


SLP 1 


7SET UP TEMPORARIES 


a § 
foal 
wor 


154 
Eac 


A mismatch takes 148 cycles 


Wor 
str 
exc 
sub 


Program 69 bytes 


Dat 


8C FIND THE POSITION OF A SUBSTRING (POS) 299 


imple formula is impossible: but the 
lawing statements are true, and a 
st case is given. 


“—eo6“e “NS NS 


cycles overhead 
h match of 1 character takes 564 cycles 


st case timing will be when the 
ing and substring always match 
ept for the last character of the 
string, such as 

string = “AAAAAAAAAB” 

substring = “AAB’ 


a 7 bytes 


we “=e ve “8 wR “ES NS UE UMS UNE UNS US UNE NE 8S 


sEXIT IF STRING OR SUBSTRING HAS ZERO LENGTH 


LD 
EX 
LD 
OR 
JR 
INC 
LD 
LD 
LD 
LD 
OR 
JR 


(STRING), HL 


DE, HL 

A, CHL) 

A 

Z,NOTFND 
HL 
(SUBSTG), HL 
(SUBLEN),A 
C,A 

A, (DE) 

A 

Z,NOTFND 


?SAVE STRING ADDRESS 

s;TEST LENGTH OF SUBSTRING 

s;EXIT IF LENGTH OF SUBSTRING = 0 
7;MOVE PAST LENGTH BYTE OF SUBSTRING 
7;SAVE SUBSTRING ADDRESS 


7C = SUBSTRING LENGTH 
7; TEST LENGTH OF STRING 


EXIT IF LENGTH OF STRING = QO 


;NUMBER OF SEARCHES = STRING LENGTH - SUBSTRING LENGTH 


; + i. 


? 
e 
? 
a 
La 
a 
g 
e 
y 


SUB 
JR 
INC 
LD 
SUB 
LO 


7 SEARCH 


LD 
INC 
LD 
LD 


AFTER THAT, 


Cc 
C,NOTFND 
A 

B,A 

A 
CINDEX),A 


UNTIL REMAI 


HL, INDEX 
CHL) 

HL., SUBLEN 
C, CHL) 


NO USE SEARCHING SINCE THERE AREN’T 


ENQUGH CHARACTERS LEFT TQ HOLD SUBSTRING 


IF SUBSTRING IS LONGER THAN STRING, EXIT IMMEDIATELY AND 
INDICATE SUBSTRING NOT FOUND 


7A = STRING LENGTH - SUBSTRING LENGTH 
s;EXIT IF STRING SHORTER THAN SUBSTRING 
;COUNT = DIFFERENCE IN LENGTHS + 1 


INITIAL STARTING INDEX = 0 


NING STRING SHORTER THAN SUBSTRING 
s INCREMENT STARTING INDEX 


7;C = LENGTH OF SUBSTRING 
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LD HL, (STRING) 3 INCREMENT TQ NEXT BYTE OF STRING 
INC HL 
LD (STRING), HL 7 HL NEXT ADDRESS IN STRING 


Hoi 


LD DE, (SUBSTG) 7 DE STARTING ADDRESS OF SUBSTRING 
7C = CURRENT VALUE OF CQUNT 


7;TRY TO MATCH SUBSTRING STARTING AT INDEX 
sMATCH INVOLVES COMPARING CORRESPONDING CHARACTERS 
; QNE AT A TIME 


CMPLP : 
LD A, (DE) GET A CHARACTER OF SUBSTRING 
CP CHL) ;COMPARE TQ CHARACTER OF STRING 
IR NZ, SLP2 ;JUMP IF NOT SAME 
DEC Cc 
IR Z, FOUND sJUMP IF SUBSTRING FQUND 
INC HL s;PROCEED TO NEXT CHARACTERS 
INC DE 
IR CMPLP 
sARRIVE HERE IF MATCH FAILS, SUBSTRING NOT YET FOUND 
SLP2: 
DINZ SLP I 7 TRY NEXT HIGHER INDEX IF 
3 ENQUGH STRING LEFT 
JR NOTFND sELSE EXIT NOT FOUND 
?FQUND SUBSTRING, RETURN ITS STARTING INDEX 
FOUND: 
LD A, CINDEX) ;SUBSTRING FOUND, A = STARTING INDEX 
RET 
;COULD NOT FIND SUBSTRING, RETURN 0 AS INDEX 
NOTFND: 
SUB A ;SUBSTRING NOT FOUND, A = 0 
RET 
;DATA 


STRING: DS 2 ;BASE ADDRESS OF STRING 
SUBSTG: DS 2 7;BASE ADDRESS GF SUBSTRING 
SLEN: DS 1 s;LENGTH OF STRING 

SUBLEN: DS 1 ;LENGTH OF SUBSTRING 
INDEX: OS 1 ;CURRENT INDEX INTO STRING 


SAMPLE EXECUTION: 


bt i) i) ee) i) 


{f) 
[ 
2 
rm) 


LD HL, STG sHL = BASE ADDRESS OF STRING 
LD DE, SSTG 7;DE = BASE ADDRESS OF SUBSTRING 
CALL POS 3;FIND POSITION OF SUBSTRING 


; SEARCHING "AAAAAAAAAB" FOR "“AAB" 
; RESULTS IN REGISTER A = 8 


=a 6eS8 ES UNS ONS 
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JR Scsc ;LOOP FOR ANOTHER TEST 

;TEST DATA, CHANGE FOR OTHER VALUES 

DB OAH LENGTH OF STRING 

DB “AAAAAAAAAB “ 332 BYTE MAX LENGTH 
DB 3H 7;LENGTH OF SUBSTRING 

DB “AAB “ 332 BYTE MAX LENGTH 


END 


Copy a Substring from a String (COPY) 


Copies a substring from a string, given a 
starting index and the number of bytes to copy. 
The strings are a maximum of 255 bytes long, 
and the actual characters are preceded bya byte 
containing the length. If the starting index of the 
substring is 0 (that is, the substring would start 
in the length byte) or is beyond the end of the 
string, the substring is given a length of 0 and 
the Carry flag is set to 1. If the substring would 
exceed its maximum length or would extend 
beyond the end of the string, then only the 
maximum number or the available number of 
characters (up to the end of the string) is placed 
in the substring, and the Carry flag is set to 1. If 
the substring can be formed as specified, the 
Carry flag is cleared. 


Registers Used: AF BC, DE, HL 


Execution Time: Approximately 21 * NUMBER OF 
BYTES COPIED plus 237 cycles overhead. NUMBER 
OF BYTES COPIED is the number specified if no 
problems occur, or the number available, or the maxi- 
mum length of the substring if copying would extend 
beyond either the string or the substring. If, for 
example, NUMBER OF BYTES COPIED = 12; 
(0Cj¢), the execution time is 
21 * 12+ 237 = 252 + 237 = 489 cycles 


Program Size: 73 bytes 


Data Memory Required: Two bytes anywhere in 
RAM for the maximum length of the substring 
(address MAXLEN) and an error flag (address 
CPYERR) 

Special Cases: 


1. Ifthe number of bytes to copy is 0, the program 
assigns the substring a length of 0 and clears the Carry 
flag, indicating no errors. 


Entry Conditions 


Base address of substring in DE 
Base address of string in HL 
Number of bytes to copy in B 


302 


SD 


Procedure: The program exits immediately if 
the number of bytes to copy, the maximum 
length of the substring, or the starting index is 0. 
It also exits immediately if the starting index 
exceeds the length of the string. If none of these 
conditions holds, the program checks if the 
number of bytes to copy exceeds either the 
maximum length of the substring or the number 
of characters available in the string. If either is 
exceeded, the program reduces the number of 
bytes to copy appropriately. It then copies the 
proper number of bytes from the string to the 
substring. The program clears the Carry flag if 


the substring can be formed as specified and sets 


the Carry flag if it cannot. 


2. Ifthe maximum length of the substring is 0, the 
program assigns the substring a length of 0 and sets 
the Carry flag to 1, indicating an error. 


3. If the starting index of the substring is 0, the 
program assigns the substring a length of 0 and sets 
the Carry flag to 1, indicating an error. 


4. Ifthe source string does not even reach the speci- 
fied starting index, the program assigns the substring 
a length of 0 and sets the Carry flag to 1, indicating an 
error. 


5. If the substring would extend beyond the end of 
the source string, the program places all the available 
characters in the substring and sets the Carry flag to 
1, indicating an error. The available characters are 
the ones from the starting index to the end of the 
string. 


6. Ifthe substring would exceed its specified maxi- 
mum length, the program places only the specified 
maximum number of characters in the substring. It 
sets the Carry flag to 1, indicating an error. 





Starting index to copy from in C 
Maximum length of substring in A 
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Exit Conditions 


Substring contains characters copied from string. 
If the starting index is 0, the maximum length of 
the substring is 0, or the starting index is beyond 
the length of the string, the substring will havea 
length of 0 and the Carry flag will be set to 1. If 


Examples 


1. Data: String= 1OSLET Y!1 = R7+ X4 
(10;¢ = 16,9 is the length of the string) 

Maximum length of substring = 2 

Number of bytes to copy = 2 

Starting index = § 

Substring = 02‘Y1’ (2 is the length of the 
substring) 

Two bytes from the string were copied, 
starting at character #5 (that is, characters 
5 and 6) 

Carry = 0, since no problems occurred in 
forming the substring. 


Result: 


2. Data: String = 0E‘8657 POWELL ST’ 

(OE,6 = 14,9 is the length of the string) 
Maximum length of substring = 10), = 16) 
Number of bytes to copy = 0D j¢ = 134 
Starting index = 6 
Substring = 09'POWELL ST” (09 is the 

length of the substring) 

Carry = 1, since there were not enough 
characters available in the string to provide 
the specified number of bytes to copy. 


Result: 


Title 


Name: Capy 


~s “we we ws “8 wR WB WB 


Copy a substring from a string 


the substring would extend beyond the end of 
the string or would exceed its specified maximum 
length, only the available characters from the 
string (up to the maximum length of the substring) 
are copied into the substring; the Carry flag is set 
in this case also. If no problems occur in forming 
the substring, the Carry flag is cleared. 


3. Data: String= 169414 HEGENBERGER DRIVE’ 
(16)¢ = 22,9 is the length of the string) 

Maximum length of substring = 1016 = 16,9 

Number of bytes to copy = lj = 1749 

Starting index = 6 

Substring = 10°.HEGENBERGER DRIV’ 
(1016 = 16,9 is the length of the substring) 

Carry = 1, since the number of bytes to copy 
exceeded the maximum length of the sub- 
string. 


Result: 


ST ee ee ee ee ee) 
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“se 68 6A 


a eT eS et | eS ee 


~“<ws 


=a “ee 6“MS8 MAR US OS 


“a8 “S “2 “8 “WE NE “E¢ WE “SE WA Se ME UMS OME OME 


“=e 6S 


Tt i) i, ee et | 


COPY 


Purposes Copy a substring from a string given a starting 
index and the number of bytes 


Entrys Register pair HL = Address of source string 


Register pair DE = Address of destination string 


Register A = Maximum length of destination 
string 

Register B = Number of bytes ta capy 

Register C = Starting index into source string 
Index of 1 is first character of 
string 


A string is a maximum of 255 bytes long plus 
a length byte which precedes it. 


Exits Destination string := The substring from the 
string. 
if no errors then 
CARRY := 0 
else 
begin 
the following conditions cause an 
error and the CARRY flag = 1. 
if (index = 0) ar (maxlen = 0) or 
(index > length(source)) then 
the destination string will have a zere 
length. | 
if (index + count - 1) > length(soaurce) 
then 
the destination string becomes everything 
fram index to the end of saqurce string. 
END: 


Registers used: AF, BC, DE,HL 


Times Approximately (21 # caunt) cycles plus 2:37 
cycles overhead. 


Sizes: Program 73 bytes 
Data 2 bytes 


7;SAVE MAXIMUM LENGTH OF DESTINATION STRING 
LD (MAXLEN),A 7SAVE MAXIMUM LENGTH 


s INITIALIZE LENGTH OF DESTINATION STRING AND ERROR FLAG 

SUB A 

LD (DE),A s;LENGTH OF DESTINATION STRING = ZERO 
LD (CPYERR),A 7;ASSUME NO ERRORS 


7IF NUMBER OF BYTES TO COPY IS 0, EXIT WITH NO ERRORS 
QR B 7;TEST NUMBER OF BYTES TO COPY 


ol et et ee i) i ee, | eS 2 eS et ee et et ee ee |) ey | |) et ee) ee ee ee eT | 


“se <se va wea “eA “Oe NE NER NS 


CNT 10K : 


8D COPY A SUBSTRING FROM A STRING (coPY) 305 


RET Zz sEXIT WITH NO ERRORS 
; CARRY = 0 

7IF MAXIMUM LENGTH IS 0, TAKE ERROR EXIT 

LD A, (MAXLEN) TEST MAXIMUM LENGTH 

OR A 

JR Z,EREXIT sERROR EXIT IF MAX LENGTH IS 0 

3IF STARTING INDEX IS ZERO, TAKE ERROR EXIT 

LD A,C s;TEST STARTING INDEX 

GR A 

JR Z,EREXIT s;ERROR EXIT IF INDEX IS 0 

7IF STARTING INDEX IS GREATER THAN LENGTH OF SOURCE 

; STRING, TAKE ERROR EXIT 

LD A, CHL) 7;GET LENGTH OF SQURCE STRING 

CP C 7;COMPARE TO STARTING INDEX 

RET Cc 7;ERROR EXIT IF LENGTH LESS THAN INDEX 
; CARRY = 1 


sCHECK IF COPY AREA FITS IN SOURCE STRING 

sOTHERWISE, COPY ONLY TO END OF STRING 

s;COPY AREA FITS IF STARTING INDEX + NUMBER OF 

; CHARACTERS TQ COPY - 1 IS LESS THAN OR EQUAL TO 

; LENGTH OF SOURCE STRING 

s;NOTE THAT STRINGS ARE NEVER MORE THAN 255 BYTES LONG 


LO a,c ;FORM STARTING INDEX + COPY LENGTH 
ADD A,B 

UR C,RECALC ;JUMP IF SUM > 255 

DEC ti‘ 

CP (HL) 

JR C,CNT10K ;JUMP IF MORE THAN ENOUGH TO COPY 
JR Z,CNT1OK ;JUMP IF EXACTLY ENOUGH 


7CALLER ASKED FOR TOO MANY CHARACTERS. RETURN EVERYTHING 
; BETWEEN INDEX AND END OF SOURCE STRING. 
; SET COUNT := LENGTHCSOQURCE) - INDEX + 1; 


LD A, OFFH s INDICATE TRUNCATION OF COUNT 
LD (CPYERR),A 

LD A, CHL) ;COUNT = LENGTH - INDEX + 1 
SUB C 

INC A 

LO B,A 7CHANGE NUMBER OF BYTES 


;CHECK IF COUNT LESS THAN OR EQUAL TO MAXIMUM LENGTH OF 

3 DESTINATION STRING. IF NOT, SET COUNT TO MAXIMUM LENGTH 
; IF CQUNT > MAXLEN THEN 

; COUNT := MAXLEN 


LD A, (MAXLEN) 7IS MAX LENGTH LARGE ENOUGH? 
CP B 

JR NC, CNT20K ;JUMP IF IT I5 

LO B,A ;ELSE LIMIT COPY TO MAXLEN 


LD A, OFFH ; INDICATE STRING OVERFLOW 
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LD (CPYERR),A 
*MOVE SUBSTRING TO DESTINATION STRING 
CNT20K: 
LD A,B * TEST NUMBER OF BYTES Ta COPY 
OR A 
JR Z,EREXIT sERROR EXIT IF NO BYTES TO COPY 
LO B,O0 *START COPYING AT STARTING INDEX 
AnD HL, BC 
LD (DE),A :SET LENGTH OF DESTINATION STRING 
LD C,A sRESTORE NUMBER OF BYTES 
INC DE *MOVE DESTINATION ADDRESS PAST 
: LENGTH BYTE 
LDIR sCOPY SUBSTRING 
sCHECK FOR COPY ERROR 
LO A, (CPYERR) : TEST FOR ERRORS 
QKEXITs 
OR A 
RET Z sRETURN WITH C = 0 IF NQ ERRORS 
sERROR EXIT 
EREXIT: | 
SCF sSET CARRY TQ INDICATE AN ERROR 
RET 
sDATA SECTION 
MAXLEN: DS 1 sMAXIMUM LENGTH OF DESTINATION STRING 
CPYERR: OS 1 sCOPY ERROR FLAG 
; 
; SAMPLE EXECUTION: 
Scena: 
LD HL,SSTG sSOURCE STRING 
LO DE, DSTG sDESTINATION STRING 
LD A, (IDX) 
LD C,A sSTARTING INDEX FOR COPYING 
LD A, (CNT) 
LD B,A sNUMBER OF BYTES Ta COPY 
LD A, (MXLEN) sMAXIMUM LENGTH OF SUBSTRING 
CALL COPY COPY SUBSTRING 


7;COPYING 3 CHARACTERS STARTING AT 
> INDEX 4 FROM 712.345E+10° GIVES “345° 


JR scep sLQQP FOR MORE TESTING 
sDATA SECTICN 


IDX: DB 4 sSTARTING INDEX FOR COPYING 
CNT: DB 3 ;NUMBER OF CHARACTERS TO COPY 


~—ae “so 6ws SS «SE 
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MXLEN: DB 20H 7;MAXIMUM LENGTH OF DESTINATION STRING 
SSTG: DB OAH 7;LENGTH OF STRING 

DB “12. 34S5E+10 “ 332 BYTE MAX LENGTH 
DSTG: DB 0 s;LENGTH OF SUBSTRING 

DB ? “ 332 BYTE MAX LENGTH 


END 


Delete a Substring from a String (DELEIE) 


Deletes a substring from a string, given a start- 
ing index and a length. The string is a maximum 
of 255 bytes long, and the actual characters are 
preceded by a byte containing the length. The 
Carry flag is cleared if the deletion can be per- 
formed as specified. The Carry flag is set if the 
starting index is 0 or beyond the length of the 
string; the string is left unchanged in either case. 
If the deletion extends beyond the end of the 
string, the Carry flag is set to | and only the 
characters from the starting index to the end of 
the string are deleted. 

Procedure: The program exits immediately if 
either the starting index or the number of bytes 


Registers Used: AF BC, DE, HL 


Execution Time: Approximately 21 * NUMBER OF 
BYTES MOVED DOWN + 224 cycles, where NUM- 
BER OF BYTES MOVED DOWN is zero if the string 
can be truncated and is STRING LENGTH — 
STARTING INDEX — NUMBER OF BYTES TO 
DELETE + 1 if the string must be compacted. That 
is, it takes extra time when the deletion creates a 
“hole” in the string that must be filled by compaction. 


Examples 


1, STRING LENGTH = 204¢ (3210) 
STARTING INDEX = 19j¢ (2540) 
NUMBER OF BYTES TO DELETE = 08 


Since there are exactly eight bytes left in the string 
starting at index 19,,, all the routine must do is trun- 
cate (that is, cut off the end of the string). This takes 

21 * 0+ 224 = 224 cycles 


2. STRING LENGTH = 404¢ (64,0) 
STARTING INDEX = 19)¢ (25,0) 
NUMBER OF BYTES TO DELETE = 08 


Entry Conditions 


Base address of string in HL 
Number of bytes to delete in B 
Starting index to delete from in C 
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to delete is 0. It also exits if the starting index is 
beyond the length of the string. If none of these 
conditions holds, the program checks to see if the 
string extends beyond the area to be deleted. If it 
does not, the program simply truncates the string 
by setting the new length to the starting index 
minus 1. If it does, the program compacts the 
resulting string by moving the bytes above the 
deleted area down. The program then determines 
the new string’s length and exits with the Carry 
cleared if the specified number of bytes were 
deleted or with the Carry set to | if any errors 
occurred. 


Since there are 20)¢ (3219) bytes above the truncated 
area, the routine must move them down eight posi- 
tions to fill the “hole.” Thus NUMBER OF BYTES 
MOVED DOWN = 32,9 and the execution time is 

21 * 32 + 224 = 672 + 224 = 896 cycles 


Program Size: 58 bytes 


Data Memory Required: One byte anywhere in 
RAM for an error flag (address DELERR) 


Special Cases: 


1. If the number of bytes to delete is 0, the 
program exits with the Carry flag cleared (no errors) 
and the string unchanged. 


2. Ifthe string does not even extend to the specified 
starting index, the program exits with the Carry flag 
set to | (indicating an error) and the string unchanged. 


3. If the number of bytes to delete exceeds the 
number available, the program deletes all bytes from 
the starting index to the end of the string and exits 
with the Carry flag set to | (indicating an error). 





Exit Conditions 


Substring deleted from string. If no errors occur, 
the Carry flag is cleared. If the starting index is 0 
or beyond the length of the string, the Carry flag 
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Examples 


1. 


“we o~“ve 6S“S8& “NB ONE UNS OWE 


<8 


bt ee) i en a i i ee) | ee) | ey | 


Data: 


Result: 


String = 26°SALES FOR MARCH AND 
APRIL OF THIS YEAR’ 
(2616 = 389 is the length of the string) 
Number of bytes to delete = 0Ai¢ = 1019 
Starting index to delete from = 106 = 1649 


String= 1C ‘SALES FOR MARCH OF THIS 
YEAR’ (1Cig = 289 is the length of the 
string with ten bytes deleted starting with 
the 16th character—the deleted material is 
‘AND APRIL ’) 

Carry = 0, since no problems occurred in the 
deletion. 


A string is a maximum of 255 bytes long plus 
a length byte which precedes 


if no errors 
CARRY := 0 
else 


is set and the string is unchanged. If the number 
of bytes to delete would go beyond the end of the 
string, the Carry flag is set and the characters 
from the starting index to the end of the string 


are deleted. 


2. Data: 


Result: 


Delete a substring fram a string 


Delete a substring from a string given a 
index and a length 


pair HL = Base address of string 

B = Number of bytes to delete 
Starting index into the string. 
An index of 1 is the first character 


Title: 
Names: Delete 
Purposes 
starting 
Entry: Register 
Register 
Register C = 
Exits Substring deleted. 


then 


String = 28°THE PRICE IS $3.00 ($2.00 
BEFORE JUNE 1)’ (28)¢ = 40j9 is the 
length of the string) 

Number of bytes to delete = 30)¢ = 4819 

Starting index to delete from = 136 = 1949 


String = 12°THE PRICE IS $3.00’ (12), = 
18, is the length of the string with all 
remaining bytes deleted) 

Carry= 1, since there were not as many bytes 
left in the string as were supposed to be 
deleted. 


at i) i) et nL i) ee) eT 


it. 
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DELETE: 


begin 
the following conditions cause an 
error with CARRY = 1. 
if €index = 0) or Cindex > length(string)) 
then do not change string 
if count is toc large then 
delete only the characters from 
index ta end of string 
end; 


Registers used: AF,BC,DE,HL 


Time: Approximately 21 ® (LENGTH(STRG)-INDEX-COUNT+1) 
Plus 224 cycles overhead 

Size: Program 38 bytes 
Data 1 bytes 


7INITIALIZE ERROR INDICATOR (DELERR) TO 0 
SUB A 
LO (DELERR),A 7;ASSUME NO ERRORS 


7;CHECK IF COUNT AND INDEX ARE BOTH NON-ZERO 
OR B 7;TEST NUMBER OF BYTES TO DELETE 


RET Zz 7;RETURN WITH CARRY = 0 (NO ERRORS) IF 
; O BYTES TO DELETE 

LD A,C 7;TEST STARTING INDEX 

OR A 

SCF 7CARRY = 1 

RET Z 7;ERROR EXIT (CARRY = 1) IF 


; STARTING INDEX = 0 


7;CHECK IF STARTING INDEX WITHIN STRING 
; ERROR EXIT IF NOT 


LO A, CHL) 7;GET LENGTH 
CP Cc 71S INDEX WITHIN STRING? 
RET Cc s;NQ, TAKE ERROR EXIT 


BE SURE ENOUGH CHARACTERS ARE AVATLABLE 
IF NOT, DELETE ONLY TO END OF STRING 
IF INDEX + NUMBER OF CHARACTERS - 1 > LENGTHCSTRING) THEN 
NUMBER OF CHARACTERS := LENGTHCSTRING) - INDEX + 1 


~s “se “SB “SS 


LD A,C 7GET INDEX 

ADD A,B 7ADD NUMBER OF CHARACTERS TO DELETE 

AR C, TRUNC 7; TRUNCATE IF SUM > 255 

LD E,A 7;SAVE SUM AS STARTING INDEX FOR MOVE 

DEC A 

CP CHL) ;COMPARE TQ LENGTH 

JR C, CNTOR 7JUIMP IF ENQUGH CHARACTERS AVAILABLE 

JIR Z, TRUNC TRUNCATE BUT NO ERRORS CEXACTLY ENOUGH 
; CHARACTERS) 

LD A, OFFH ; INDICATE ERROR - NOT ENOUGH CHARACTERS 


LD (DELERR),A ; AVAILABLE FOR DELETION 


=s “as ~“~s ~wse we we “SA “ES wR wR VS NS WS UR UR UNS UNE UR NE 


TRUNC: 


CNTOK : 


OKEXIT: 


DELERR: 


=s ué “8 “SB OMS 


SCSE: 
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7 TRUNCATE STRING — NQ COMPACTING NECESSARY 
; STRING LENGTH = INDEX - 1 


LD A,C ;STRING LENGTH = INDEX - 1 
DEC A 

LO CHL)I,A 

LO A, (DELERR) 

RRA sCARRY = O IF NO ERRORS 
RET sEXIT 


7;DELETE SUBSTRING BY COMPACTING 
; MOVE ALL CHARACTERS ABOVE DELETED AREA DOWN 
;NEW LENGTH = OLD LENGTH ~ NUMBER OF BYTES TO DELETE 


LD A, CHL) 
LD D,A ;SAVE OLD LENGTH 
SUB B 7;SET NEW LENGTH 
LD CHL), A 


7CALCULATE NUMBER OF CHARACTERS TO MOVE 
; NUMBER = STRING LENGTH —- CINDEX + NUMBER OF BYTES) + 1 


LD A,D :GET OLD LENGTH 
SLIB E sSUBTRACT INDEX + NUMBER OF BYTES 
INC A sA = NUMBER OF CHARACTERS TO MOVE 


7;CALCULATE SQURCE AND DESTINATION ADDRESSES FOR MOVE 
;SQURCE = BASE + INDEX + NUMBER OF BYTES TO DELETE 
;DESTINATION = BASE + INDEX 


PUSH HL 7SAVE STRING ADDRESS 

LD B,90 ;DESTINATION = BASE + INDEX 

ADD HL, BC 

EX CSP),HL ;SQURCE = BASE + INDEX + NUMBER 

LD 0,0 >; QF BYTES TO DELETE 

ADD HL, DE sHL = SOURCE (ABOVE DELETED AREA) 
POP DE ;DE = DESTINATION 

LD C,A 7;BC = NUMBER OF CHARACTERS TO MOVE 
LDIR s;COMPACT STRING BY MOVING DOWN 
7;GOO0D EXIT 

OR A 7;CLEAR CARRY, NC ERRORS 

RET 

;DATA 

DS 1 DELETE ERROR FLAG 


SAMPLE EXECUTION: 


“se “68 “8 wB MS 


LD HL,SSTG ;HL = BASE ADDRESS OF STRING 
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LD A, (IDX) 

LO C,A 7C = STARTING INDEX FOR DELETION 

LD A, (CNT) 

LD B,A 7B = NUMBER OF CHARACTERS TO DELETE 


CALL DELETE ;DELETE CHARACTERS 
7;DELETING 4 CHARACTERS STARTING AT INDEX 1 
; FROM "JOE HANDOVER" LEAVES "HANDOVER" 


JR SCSE 7;LOOP FOR ANOTHER TEST 

7DATA SECTION 
IDX: DE i sSTARTING INDEX FOR DELETION 
CNT: DB 4 ;NUMBER OF CHARACTERS TO DELETE 
SSTG: DB 12 ;LENGTH OF STRING 

DB “JOE HANDOVER” 


END 


Insert a Substring into a String (INSEIT) 


Inserts a substring into a string, given a start- 
ing index. The string and substring are both a 
maximum of 255 bytes long, and the actual 
characters are preceded by a byte containing the 
length. The Carry flag is cleared if the insertion 
can be accomplished with no problems. The 
Carry flag is set if the starting index is 0 or beyond 
the length of the string. In the second case, the 
substring is concatenated to the end of the string. 
The Carry flag is also set if the string with the 
insertion will exceed a specified maximum length. 
In that case, the program inserts only enough of 
the substring to give the string its maximum 
length. 

Procedure: The program exits immediately if 
the starting index or the length of the substring 
is 0. If neither is 0, the program checks to see if 
the insertion will produce a string longer than 


Registers Used: AF, BC, DE, HL 


Execution Time: Approximately 21 * NUMBER 
OF BYTES MOVED + 21 * NUMBER OF BYTES 
INSERTED-+ 290. NUMBER OF BYTES MOVED 
is the number of bytes that must be moved to 
create space for the insertion. If the starting index is 
beyond the end of the string, NUMBER OF BYTES 
MOVED is O since the substring is simply concatenated 
to the string. Otherwise, it is STRING LENGTH — 
STARTING INDEX + 1, since the bytes at or above 
the starting index must be moved. NUMBER OF 


BYTES INSERTED is the length of the substring if 
no truncation occurs. It is the maximum length of the 
string minus its current length if inserting the substring 
produces a string longer than the maximum. 


Examples 


1. STRING LENGTH = 20j¢ (3249) 
STARTING INDEX = 19)¢ (2540) 
MAXIMUM LENGTH = 3016 (48j9) 
SUBSTRING LENGTH = 06 
We want to insert a substring six bytes long, start- 
ing at the 25th character. Since eight bytes must be 





OF 


the specified maximum length. If this is the case, 
the program truncates the substring. The program 
then checks to see if the starting index 1s within 
the string. If it is not, the program simply con- 
catenates the substring by moving it to the 
memory locations immediately after the end of 
the string. If the starting index is within the 
string, the program must first make room for 
the insertion by moving the remaining characters 
up in memory. This move must start at the high- 
est address to avoid writing over any data. Final- 
ly, the program can move the substring into the 
open area. The program then determines the new 
string length and exits with the Carry flag set 
appropriately (to 01f no problems occurred and 
to | if the starting index was 0, if the substring 
had to be truncated, or if the starting index was 
beyond the length of the string). 


moved up (NUMBER OF BYTES MOVED = 32 — 
25 + 1) and six bytes must be inserted, the execution 
time is approximately 

21* 8+ 21*6+ 290= 168+ 126+ 290= 584 cycles 


2. STRING LENGTH = 204¢ (32)9) 
MAXIMUM LENGTH = 244¢ (3640) 
SUBSTRING LENGTH = 06 

Unlike Example 1, here we can insert only four 

bytes of the substring without exceeding the maximum 
length of the string. Thus, NUMBER OF BYTES 
MOVED= 8 and NUMBER OF BYTES INSERTED 
= 4, The execution time is approximately 

21* 8+ 21* 4+ 290= 168+ 84+ 290= 542 cycles 


Program Size: 90 bytes 


Data Memory Required: One byte anywhere in 
RAM for an error flag (address INSERR). 


Special Cases: 


1. Ifthe length of the substring (the insertion) is 0, 
the program exits with the Carry flag cleared (no 
errors) and the string unchanged. 
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2. If the starting index for the insertion is 0 (that 
is, the insertion would start in the length byte), the 
program exits with the Carry flag set to | (indicating 
an error) and the string unchanged. 


3. If the string with the substring inserted exceeds 
the specified maximum length, the program inserts 
only enough characters to reach the maximum length. 
The Carry flag is set to 1 to indicate that the insertion 
has been truncated. 


Entry Conditions 


Base address of substring in DE 

Base address of string in HL 

Maximum length of string in B 

Starting index at which to insert the 
substring in C 


Examples 


1. Data: String = OASJOHN SMITH’ (OAj¢ = 109 is 
the length of the string) 

Substring = 08°WILLIAM’ (08 is the length 
of the substring) 

Maximum length of string = 14,¢ = 20) 


Starting index = 06 


String = 12,JOHN WILLIAM SMITH’ 
(12;¢6 = 18,9 1s the length of the string 
with the substring inserted) 

Carry = 0, since no problems occurred in the 
insertion. 


Result: 


4. If the starting index of the insertion is beyond 
the end of the string, the program concatenates the 
insertion at the end of the string and indicates an 
error by setting the Carry flag to 1. 


5. If the original length of the string exceeds its 
specified maximum length, the program exits with 
the Carry flag set to | (indicating an error) and the 
string unchanged. 





Exit Conditions 


Substring inserted into string. If no errors occur, 
the Carry flag is cleared. If the starting index or 
the length of the substring is 0, the Carry flag is 
set and the string is not changed. If the starting 
index is beyond the length of the string, the Carry 
flag is set and the substring is concatenated to the 
end of the string. If the string with the substring 
inserted would exceed the specified maximum 
length, the Carry flag is set and only those char- 
acters from the substring which bring the string 
to maximum length are inserted. 


2. Data: String = OASJOHN SMITH’ (OAj¢ = 1049 is 
the length of the string) 
Substring = OC'-ROCKEFELLER’ (0Cj¢ = 
12) is the length of the substring) 
Maximum length of string = 14;¢ = 20) 
Starting index = 06 
Result: String= 14°,JOHN ROCKEFELLESMITH’ 


(1416 = 20) is the length of the string with 
as much of the substring inserted as the 
maximum length would allow) 

Carry = 1, since some of the substring could 
not be inserted without exceeding the maxi- 
mum length of the string. 
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INSERT: 


Title: 
Name: 


Purposes: 


Entry: 


Exits 


Registers used: 


Time: 


Sizes 
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Insert a substring inte a string 
Insert 


Insert a substring into a string given a 
starting inde» 


Register pair HL = Address of string 

Register pair DE = Address of substring ta 
insert 

Maximum length af string 

Starting index to insert the 

substring 


Register B 
Register C 


A string is a maximum of 255 bytes long plus 
a length byte which precedes it. 


Substring inserted into string. 
if no errors then 
CARRY = 0 
else 
begin 
the following conditions cause the 
CARRY flag to be set. 
if index = 0 then 
deo not insert the substring 
if length(strg) > maximum length then 
do not insert the substring 
if index > length‘strg) then 
concatenate substg onto the end of the 
source string 
if length(strg)+length(substring) > maxlen 
then insert only enough of the substring 
to reach maximum length 
end; 


AF, BC, DE, HL 


Approximately 

2i # (LENGTH(STRG) - INDEX + 1) + 
21 # (LENGTH(SUBSTG)) + 

290 cycles overhead 


Program 37O bytes 
Data 1 byte 


7INITIALTIZE ERROR FLAG 
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SUB A ;ERROR FLAG = 0 (NO ERRORS) 
LD CINSERR),A 

7;GET SUBSTRING AND STRING LENGTHS 

; IF LENGTH(SUBSTG) = O THEN EXIT BUT NO ERROR 


LO A, (DE) TEST LENGTH OF SUBSTRING 
OR A 
RET Z sEXIT IF SUBSTRING EMPTY 


> CARRY = 0 (NOG ERRORS) 


7IF STARTING INDEX IS ZERO, TAKE ERROR EXIT 


IDXO: 
LO A,C TEST STARTING INDEX 
OR A 
SCF sASSUME AN ERRCGR 
RET Z sRETURN WITH ERROR IF INDEX = 0 
CHECK WHETHER INSERTION WILL MAKE STRING TOO LONG 
s IF IT WILL, TRUNCATE SUBSTRING AND SET 
: TRUNCATION FLAG. 
es INSERTION TOO LONG IF STRING LENGTH + SUBSTRING LENGTH 
* EXCEEDS MAXIMUM LENGTH. REMEMBER, STRINGS CANNOT BE 
s MORE THAN 255 BYTES LONG 
CHKLEN: 
Ln A, (DE) *TOTAL = STRING + SUBSTRING 
ADD A, CHL) 
JR C, TRUNC TRUNCATE SUBSTRING IF NEW LENGTH > 255 
CP B COMPARE TO MAXIMUM LENGTH GF STRING 
LD A, (DE) 7A = LENGTH OF SUBSTRING 
JR C, IDXLEN s JUMP IF TOTAL < MAX LENGTH 
JR Z, TOXLEN s OR EQUAL 
:SUBSTRING DOES NOT FIT, SOQ TRUNCATE IT 
s SET ERROR FLAG TO INDICATE TRUNCATICN 
s LENGTH THAT FITS = MAXIMUM LENGTH — STRING LENGTH 
TRUNC : 
Lo A, OFFH s INDICATE SUBSTRING TRUNCATED 
LD CINSERR),A 
LD A,B sLENGTH = MAX - STRING LENGTH 
SUB CHL > 
RET Cc sRETURN WITH ERROR IF STRING TOOQ 
SCF : LONG INITIALLY QR ALREADY MAX 
RET Z s LENGTH SO NO ROOM FOR SUBSTRING 
sCHECK IF INDEX WITHIN STRING. IF NOT, CONCATENATE 
: SUBSTRING ONTO END OF STRING 
IDXLEN: 
LD B,A :B = LENGTH OF SUBSTRING 
LD A, CHL) s;GET STRING LENGTH 
CP C sCOMPARE TO INDEX 
JR NC, LENOK sJUMP IF STARTING INDEX WITHIN STRING 


7; INDEX NOT WITHIN STRING, SOQ CONCATENATE 

; NEW LENGTH OF STRING = OLD LENGTH + SUBSTRING LENGTH 
Lo C,A ;SAVE CURRENT STRING LENGTH 
ADD A,B sADD LENGTH OF SUBSTRING 


IDXL1: 


LENOK : 
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LD CHLD,A 7;SET NEW LENGTH OF STRING 
7;SET ADDRESSES FOR CONCATENATION 
; DE = STRING ADDRESS + LENGTH(STRING) + 1 


7; HL = SUBSTRING ADDRESS 


EX DE, HL 7HL = SUBSTRING ADDRESS 

LD A,C 7DE = END OF STRING 

INC A 

ADD A,E 

LD E,A 

JR NC, TOXL1 

INC 0 

LD A, OFFH 7; INDICATE INSERTION ERROR 

LD CINSERR),A 

JR MVESUB ;JUST MOVE, NOTHING TO OFEN UP 


;OPEN UP SPACE IN SQURCE STRING FOR SUBSTRING BY MOVING 

; CHARACTERS FROM END OF SOURCE STRING DOWN TO INDEX, UP BY 
; SIZE OF SUBSTRING. 

; A = LENGTH(STRING) 


PUSH BC ;SAVE LENGTH OF SUBSTRING 
PUSH DE 7;SAVE ADDRESS OF SUBSTRING 
7;NEW LENGTH OF STRING = OLD LENGTH + SUBSTRING LENGTH 
LD E,A ;DE = STRING LENGTH 

LD D,90 

ADD A,B 

LD CHLI,A 7;STQORE NEW LENGTH OF STRING 


7;CALCULATE NUMBER OF CHARACTERS TO MOVE 
; = STRING LENGTH - STARTING INDEX + 1 


LD A,E 7;GET ORIGINAL LENGTH OF STRING 
SUB Cc 
INC A 7A = NUMBER OF CHARACTERS TO MOVE 


7;CALCULATE ADDRESS OF LAST CHARACTER IN STRING. THIS IS 
; SOURCE ADDRESS = STRING ADDRESS + LENGTH(STRING) 


ADD HL, DE s;HL POINTS TQ LAST CHARACTER IN STRING 
LD E,t 7;DE ALSO 
LD D,H 


;CALCULATE DESTINATION ADDRESS 

; = STRING ADDRESS + LENGTHCSTRING) + LENGTH OF SUBSTRING 
THIS MOVE MUST START AT HIGHEST ADDRESS AND WORK DOWN 

; TQ AVOID OQVERWRITING PART OF THE STRING 


LO C,B 7;BC = LENGTH OF SUBSTRING 
LD B,9O 

ADD HL, BC 

EX DE, HL 7 HL SOURCE ADDRESS 


DESTINATION ADDRESS 
NUMBER OF CHARACTERS TQ MOVE 


=| 
m 
tou ow 


LO C,A >BC 
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LDOR 7;O0PEN UP FOR SUBSTRING 
FRESTORE REGISTERS 
EX DE, HL. 
INC DE 7DE = ADDRESS TO MOVE STRING TO 
POP HL 7;HL = ADDRESS OF SUBSTRING 
POP BC 7B = LENGTH OF SUBSTRING 
7;MOVE SUBSTRING INTO OPEN AREA 
; HL = ADDRESS OF SUBSTRING 
; DE = ADDRESS TO MOVE SUBSTRING TO 
; C = LENGTH OF SUBSTRING 
MVESUB: 
INC HL s INCREMENT PAST LENGTH BYTE OF SUBSTRING 
LD C,B 7;BC = LENGTH OF SUBSTRING TO MOVE 
LD B,O 
LDIR ?;MOQVE SUBSTRING INTQ OPEN AREA 
LD A, CINSERR) 7GET ERROR FLAG 
RRA 7;IF INSERR <> O THEN CARRY = 1 
; TO INDICATE AN ERROR 
RET 
;DATA SECTION 


INSERR: DS 


“ewe 6sSB SS 


SCE&F 
LD 
LD 
LD 
LD 
LD 
LD 


1 s;FLAG USED TO INDICATE ERROR 


SAMPLE EXECUTION: 


HL,STG ;HL = BASE ADDRESS OF STRING 
DE,SSTG ;DE = BASE ADDRESS OF SUBSTRING 
A, (IDX) 

C,A 7C = STARTING INDEX FOR INSERTION 
A, (MXLEN) 

B,A 7B = MAXIMUM LENGTH OF STRING 


CALL INSERT ;INSERT SUBSTRING 


JR 


7D 
IDX: DB 
MXLEN: DR 
STG: DB 
DB 
SSTG: DB 
DR 


EN 


;RESULT OF INSERTING “—* INTO *123456° AT 
; INDEX 1 IS *-123456" 


SCaF ;LOQP FOR ANOTHER TEST 
ATA SECTION 
1 ;STARTING INDEX FOR INSERTION 
20H >MAXIMUM LENGTH OF DESTINATION 
06H 7;LENGTH OF STRING 
“123456 “ 332 BYTE MAX LENGTH 
1 ;LENGTH OF SUBSTRING 


to “ 332 BYTE MAX LENGTH 
D 


=a 6s ws “SB SS 


8-Bit Array Summation (ASUM3) 9A 


Adds the elements of an array, producing a 
16-bit sum. The array consists of up to 255 byte- 
length elements. 

Procedure: The program clears the sum initial- 
ly. It then adds elements one at a time to the less Program Size: 19 bytes 
significant byte of the sum, starting at the base Data Memory Required: None 
address. Whenever an addition produces a carry, 
the program increments the more significant 
byte of the sum. 


Registers Used: AF, B, DE, HL 


Execution Time: Approximately 38 cycles per byte- 
length element plus 49 cycles overhead 


Special Case: An array size of 0 causes an imme- 
diate exit with the sum equal to 0. 





Entry Conditions Exit Conditions 


Base address of array in HL Sum in HL 
Size of array in bytes in B 


Example 


I. Data: Array consists of 


F716 SA 6 
2316 1616 
316 CBig 
70\6 Elj¢ 


Result: Sum = (HL) = 03D71 


ws “6@ “8 “6 


<—s “8 “we “6 “s8 “SH “8 SOE 


Title 8S-bit array summation . 
Name: ASUMS ; 
: Purposes Sum the elements of an array, yielding a le6-bit ; 
; ; 


result. Maximum size is 255 


& 
rai 
Oo 
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ASUMS: 


SUMLP : 


DECCNT: 


EXIT: 


ws «48 


a “6 648 


SCIA: 


Entrys Register pair HL = Base address of array 
Register B = Size of array in bytes 


Exits Register pair HL = Sum 
Registers used: AF,B,DE,HL 


Times Approximately 38 cycles per element plus 
49 cycles overhead 


Pragram 19 bytes 


fs 
fade 
we 
& 
ss 


;TEST ARRAY LENGTH 

s,EXIT WITH SUM = O IF NOTHING IN ARRAY 

EX DE, HL 7;SAVE BASE ADDRESS OF ARRAY 

LD HL,O s INITIALIZE SUM TQ O 

s;CHECK FOR LENGTH OF ZERO 

LD A,B 7 TEST ARRAY LENGTH 

OR A 

RET Zz sEXIT WITH SUM = O IF LENGTH = 0 


2 INITIALIZE ARRAY POINTER, SUM 

EX DE, HL ;RESTORE BASE ADDRESS OF ARRAY 
3; HIGH BYTE OF SUM = 0 

SUB A 7A LOW BYTE OF SUM = 0 
7D HIGH BYTE OF SUM 


;ADD BYTE-LENGTH ELEMENTS TO SUM ONE AT A TIME 
7 INCREMENT HIGH BYTE OF SUM WHENEVER A CARRY OCCURS 


ADD A, CHL) sADD NEXT BYTE 

JR NC, DECCNT 7; JUMP IF NQ CARRY 

INC D ; ELSE INCREMENT HIGH BYTE OF SUM 
INC HL 

DUNZ SUMLP 

LO LA sHL = SLM 

LD H,D 

RET 


SAMPLE EXECUTION 


LOD HL, BUF sHL = BASE ADDRESS OF BUFFER 
LD A, (BUFSZ) 


ss ~S we “SES “EOE “WS “OQ ws 48 NSB WER ONS NS NE 


weo06wShlU6GS hUSB 6S 


LD 


CALL 


JR 


TEST DATA, 


SIZE 
BUFSZ: 


BUF: 


EQU 
DR 


DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DR 


END 


B,A 


ASUMS 
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010H 
SIZE 


OOH 
11H 
22H 
33H 
44H 
oH 
66H 
77H 
83H 
99H 
OAAH 
OBBH 
oCCH 
ODDH 
OEEH 
OF FH 


9A 8-BIT ARRAY SUMMATION (ASUM8) O24 


3B = SIZE OF BUFFER IN BYTES 


;SUM OF TEST DATA IS O7F8 HEX, 
; HL = O7FSH 


CHANGE FOR OTHER VALUES 


7;SIZE OF BUFFER IN BYTES 
;SIZE OF BUFFER IN BYTES 


7 BUFFER 

7;DECIMAL ELEMENTS ARE 0,17,34,51,68 
7 85,102,119, 135, 153, 170, 187, 204 

3 221,238,255 


7;SUM = O7FS8 (2040 DECIMAL) 


16-Bit Array Summation (ASUM 16) OB 


Adds the elements of an array, producing a 
24-bit sum. The array consists of up to 255 word- Registers Used: AF, BC, DE, HL 
length (16-bit) elements. The elements are ar- 
ranged in the usual Z80 format with the less 
significant bytes first. 


Execution Time: Approximately 68 cycles per 16- 
bit element plus 49 cycles overhead 


Procedure: The program clears the sum initial- Program Size: 25 bytes 
ly. It then adds elements to the less significant 
bytes of the sum one at a time, starting at the pate memory Recuated: None 
base address. Whenever an addition produces a 


Special Case: An array size of 0 causes an imme- 
carry, the program increments the most signifi- diate exit with the sum equal to 0. 


cant byte of the sum. 





Entry Conditions Exit Conditions 





Base address of array in HL Most significant byte of sum in E 
Size of array in 16-bit words in B Middle and least significant bytes of sum in HL 
Example 
1. Data: Array (in 16-bit words) consists of 
F7Ali¢ 53646 
31D5i¢ CBF5,¢ 
T0F 216 E1071 
Result: Sum = 03DBAL1 {¢ 
(E) = 0316 
(HL) = DBAIj, 
: Title 16-bit array summation * 
; Name: ASUM16 7 
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Purpose: Sum the elements of an array, yielding a 24-bit 
result. Maximum size is 255 14-bit elements 


ee 6a NG NO 


Entrys Register pair HL = Base address of array 
Register B = Size of array in words 


High byte of sium 
Middle byte of sum 
Low byte of sum 


Exits Register A 
Register H 
Register L 


“8 “se “8 “EB “8 48 WH WH UWS Ge OS 


Registers used: AF,BC, DE, HL 


Times: Approximately 68 cycles per element plus 
49 cycles overhead 


Sizes: Program 25 bytes 


ot | ee ee eS et | | | ee 


=e ~e “eS “8S “8 SEB 6 ONS 


ASUM16: 
7 TEST ARRAY LENGTH 
y;EXIT WITH SUM = O IF NOTHING IN ARRAY 


EX DE, HL 7;SAVE BASE ADDRESS GF ARRAY 

LO HL, © s INITIALIZE SUM TO O 

7;CHECK FOR ARRAY LENGTH OF ZERO 

LD A,B sTEST ARRAY LENGTH 

OR A 

RET Zz sEXIT WITH SUM = O IF LENGTH = Q 


s INITIALIZE ARRAY POINTER, SUM 
EX DE, HL ;BASE ADDRESS BACK TO HL 
>; LOW, MIDDLE BYTES QF SUM = 0 


LD C,E ;C = HIGH BYTE OF SUM = 0 
70 = MIDDLE BYTE OF SLIM 
7;E = LOW BYTE OF SLIM 


;ADD WORD-LENGTH ELEMENTS TO SUM ONE AT A TIME 
7 INCREMENT HIGH BYTE OF SUM WHENEVER A CARRY OCCURS 


SUMLP s 

LD A,E sADD LOW BYTES OF ELEMENT AND SUM 

ADD A, CHL) 

LD E,A 

INC HL sADD HIGH BYTE OF ELEMENT TQ 

LD A,D > MIDDLE BYTE OF SUM 

Anc A, CHL) 

LD D,A 

JR NC, DECCNT s JUMP IF NQ CARRY 

INC GC > ELSE INCREMENT HIGH BYTE OF SUM 
DECCNT: 

INC HL 


DUNZ SUMLP 
EXITs 
EX DE, HL 7;HL = MIDDLE AND LOW BYTES OF SUM 
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LD A,C 
RET 


SAMPLE EXECUTION 


Ws “68 “Ss “MS SS 


SCYB: 
LD HL, BUF 
LD A, (BUFSZ) 
LD B,A 


CALL ASUM16 


7A = HIGH BYTE OF SLIM 


“3s =2 we WS 


“ea 


HL = BASE ADDRESS OF BUFFER 
7B = SIZE QF BUFFER IN WORDS 
S 


;SUM QF TEST DATA IS 3S1iFFS HEX, 
; REGISTER PAIR HL = 1FFSH 
; REGISTER A = 3 


;SIZE OF BUFFER IN WORDS 
;SIZE OF BUFFER IN WORDS 


; BUFFER 

s;DECIMAL ELEMENTS ARE 0, 273,546,819, 1092 
— 1365, 1638, 1911, 2184, 2497, 2730, 3003, 3276 
3 56797,61166, 65535 


JR SC9B 
TEST DATA, CHANGE FOR OTHER VALUES 
SIZE EQuU O10H 
BUFSZ: DB SIZE 
BUF : DW 000H 
DW 11L1H 
DW 22a 
DW 333H 
DW 444H 
DW SOSH 
DW 666H 
DW 777H 
DW 383H 
DW 999H 
DW OAAAH 
DW OBBBH 
DW OCCCH 
DW OODDDH 
DW OEEEEH 
DW OFFFFH 


7;SUM = SIFFS (204792 DECIMAL) 


Find Maximum Byte-Length 


Element (MAXELM) 


Finds the maximum element inan array. The 
array consists of up to 255 unsigned byte-length 
elements. 

Procedure: The program exits immediate]: 
(setting Carry to 1) if the array has no elements. 
Otherwise, the program assumes that the ele- 
ment at the base address is the maximum. It then 
proceeds through the array, comparing the sup- 
posed maximum with each element and retaining 
the larger value and its address. Finally, the 
program clears Carry to indicate a valid result. 


Entry Conditions 


Base address of array in HL 
Size of array in bytes in B 


Example 


1. Data: Array (in bytes) consists of 
Ab ig 5916 
D216 TA\6 
1Big CF i¢ 
Result: The largest unsigned element is element #2 


(D2\6) 

(A) = largest element (D2,¢) 

(HL) = BASE + 2 (lowest address contain- 
ing D2j¢) 

Carry flag = 0, indicating that array size is 
non-zero and the result is valid. 


ve 









Registers Used: AF, B, DE, HL 
Execution Time: Approximately 36 to 58 cycles per 
element plus 35 cycles overhead. If, on the average, 
the program must replace the maximum in half of 
the iterations, the execution time is approximately 
94 * ARRAY SIZE/2 + 35 cycles. 
Program Size: 19 bytes 
Data Memory Required: None 
Special Cases: 

1. An array size of 0 causes an immediate exit 


with the Carry flag set to | to indicate an invalid 
result. 











2. If the largest unsigned value occurs more than 
once, the program returns with the lowest possible 
address. That is, it returns with the address closest to 
the base address that contains the maximum value. 






Exit Conditions 


Largest unsigned element in A 

Address of largest unsigned element in HL 

Carry = 0 if result is valid; | if size of array is 0 
and result is meaningless. 
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<a “Ss “a 6A WS 


a6 “8 “ws ~wEe 


“eo6<8 “GO “8 “8 YS Os UMS USS ONS Me 


-@8 “6 “8 “ES 


“8 “Ee 


“—s “@ “Ss @VS “NO WB UNS OA 


MAXELM: 


MAXLP: 


MAXLP1: 


Title Find maximum byte-length element 
Name: MAXELM 
Purposes: Given the base address and size of an array, 


find the largest element 


Entrys Register pair HL = Base address of array 
Register EB = Size of array in bytes 
Exit: If size of array not zera then 


Carry flag = 0 

Register A = Largest element 

Register pair HL = Address of that element 
if there are duplicate values af the largest 
element, register pair HL has the address 
nearest to the base address 

else 
Carry flag = i 


Registers used: AF,B,DE,HL 


Time: Appraximately 346 to S& cycles per element 
Plus 35 cycles overhead 


Sizes Frogram 19 bytes 


s;EXIT WITH CARRY SET IF NO ELEMENTS IN ARRAY 


LD A,B 7;TEST ARRAY SIZE 

OR A 

SCF 7;SET CARRY TO INDICATE ERROR EXIT 
RET Z 7;RETURN IF NO ELEMENTS 


7;REPLACE PREVIOQUS GUESS AT LARGEST ELEMENT WITH 
7 CURRENT ELEMENT. FIRST TIME THROUGH, TAKE FIRST 
; ELEMENT AS GUESS AT LARGEST 


LD A, CHL) 3;LARGEST = CURRENT ELEMENT 
LD E,L ;SAVE ADDRESS OF LARGEST 
LD D,H 


;COMPARE CURRENT ELEMENT TO LARGEST 
KEEP LOOKING UNLESS CURRENT ELEMENT IS LARGER 


DEC B 
JR Z,EXIT 
INC HL 


we “we “8 “Oe “Ss “MS WS OR OMe 


wa “es “ae M8 NS M8 UNE UNS Ne UNE UME UNE UNE MSA VAR NE UNS UR UNE UB UME UR Ne US ONE 


EXIT: 


ws 6S8 648 SE OWS 


ty 
) 
O 
a) 
ae 


SZARY 
ARY: 


CP 
JR 
JR 


OR 
EX 
RET 


CHL} 
NC, MAXLP1 
MAXLP 


A 
DE, HL 


SAMPLE EXECUTION: 


LD 
LD 
CALL 


IR 


EQU 
DB 


HL, ARY 
B, SZARY 
MAXELM 


tf} 
Cy 
Q 
5 


o 
= 


HeMW Pen oe 


9C FIND MAXIMUM BYTE-LENGTH ELEMENT (MAXELM) S22 


7COMPARE CURRENT ELEMENT, LARGEST 
s;CONTINUE UNLESS CURRENT ELEMENT LARGER 


7;ELSE CHANGE LARGEST 


CLEAR CARRY TO INDICATE NO ERRORS 
7;HL = ADDRESS OF LARGEST ELEMENT 


a2 64S “ME “SH “ME 


;HL = BASE ADDRESS OF ARRAY 
7B = SIZE OF ARRAY IN BYTES 


;RESULT FOR TEST DATA IS 

> A = FF HEX (MAXIMUM), HL = ADDRESS OF 
; FF IN ARY 

7;LOQP FOR MORE TESTING 


7SIZE OF ARRAY IN BYTES 


Find Minimum Byte-Length 


Element (MINELM) 


Finds the minimum element in an array. The 
array consists of up to 255 unsigned byte-length 
elements. 

Procedure: The program exits immediately 
(setting Carry to 1) if the array has no elements. 
Otherwise, the program assumes that the ele- 
ment at the base address is the minimum. It then 
proceeds through the array, comparing the sup- 
posed minimum to each element and retaining 
the smaller value and its address. Finally, the 
program clears Carry to indicate a valid result. 


Entry Conditions 


Base address of array in HL 
Size of array in bytes in B 


Example 


1. Data: Array (in bytes) consists of 
3546 4416 
D246 TAt6 
IBis CFi¢ 
Result: The smallest unsigned element is element #3 


(1By¢) 
(A) = smallest element (1Bj¢) 
(HL) = BASE + 3 (lowest address contain- 
ing 1B,6) 
Carry flag = 0, indicating that array size is 
non-zero and the result is valid. 


328 





9D 


Registers Used: AF, B, DE, HL 


Execution Time: Approximately 36 to 65 cycles per 
element plus 35 cycles overhead. If, on the average, 
the program must replace the minimum in half of 
the iterations, the execution time is approximately 
101 * ARRAY SIZE/2 +35 cycles. 


Program Size: 21 bytes 
Data Memory Required: None 


Special Cases: 


1. An array size of 0 causes an immediate exit 
with the Carry flag set to 1 to indicate an invalid 
result. 


2. If the smallest unsigned value occurs more 
than once, the program returns with the lowest pos- 
sible address. That is, it returns with the address 
closest to the base address that contains the min- 
imum value. 


Exit Conditions 


Smallest unsigned element in A 

Address of smallest unsigned element in HL 

Carry = 0 if result is valid; 1 if size of array is 0 
and result is meaningless. 
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is “ue “va “FS NSB NB NS WE 


bl |) en i) |) et 


Title Find minimum byte-length element 
Name: MINELM 
Purposes Given the base address and size of an array, 


find the smallest element 


Entrys Register pair HL = Base address of array 
Register & = Size of array in bytes 


“e “8s “8 “wea WA WE OMB 


Exit: If size of array not zero then 

Carry flag = 0 

Register A = Smallest element 

Register pair HL = Address of that element 

if there are duplicate values of the smallest 

element, HL will have the address 

nearest to the base address 

else 
Carry flag = l 


Registers used: AF,B, DE, HL 


te) ee) i et i i) i et et ee ee ee ee] oe] 


Times Approximately 36 to 65 cycles per element 
Plus 35 cycles overhead 


Size: Program 21 bytes 


ba i i | | ee) | | et et i eT en ey ee 


we sve wes “8 we ~“es 


MINELM: 
y;EXIT WITH CARRY SET IF NO ELEMENTS IN ARRAY 
LD A,B 7; TEST ARRAY SIZE 
OR & 
SCF ;SET CARRY TQ INDICATE AN ERROR EXIT 
RET Z s;RETURN IF NO ELEMENTS 
;REPLACE PREVIOUS GUESS AT SMALLEST ELEMENT WITH 
; CURRENT ELEMENT. FIRST TIME THROUGH, TAKE FIRST 
; ELEMENT AS GUESS AT SMALLEST 

MINLP: LD A, CHL) 7;SMALLEST = CURRENT ELEMENT 
LD E,L ;SAVE ADDRESS OF SMALLEST 
LO 0,H 
7COMPARE CURRENT ELEMENT TQ SMALLEST 
7;KEEP LOOKING UNLESS CURRENT ELEMENT IS SMALLER 

MINLP1: 

DEC B 


JR Z,EXIT 
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EXIT: 


—wae6~we “SS NS 6S 


tf) 
C3 
3 
a 
os 


SZARY 
ARY: 


INC 
CP 
JR 
JR 
JR 


OR 
EX 
RET 


SAMPLE EXECUTION: 


LD 
LD 
CALL 


JR 


EQU 
DB 


DB 
DB 
DB 
DB 


DB 
DB 
DB 
DB 
DB 
DR 
DB 


DB 
END 


HL 

CHL) 
C,MINLP1 
Z,MINLP1 
MINLP 


A 
DE, HL 


HL, ARY 
BR, SZARY 
MINELM 


7COMPARE CURRENT ELEMENT, SMALLEST 
sCONTINUE IF CURRENT ELEMENT LARGER 
; OR SAME 

s;ELSE CHANGE SMALLEST 


7;CLEAR CARRY TO INDICATE NO ERRORS 
sHL = ADDRESS OF SMALLEST ELEMENT 


HL = BASE ADDRESS OF ARRAY 
7B = SIZE OF ARRAY IN BYTES 


<s 


1 HEX (MINIMUM), HL = ADDRESS OF 


RESULT FOR TEST DATA IS 
A = 
1 IN ARY 


<we “a 46 


LOOP FOR MORE TESTING 
3SIZE OF ARRAY IN BYTES 


a9 “8 “8 “SB OWS 


Binary Search (8INSCH) 


Searches an array of unsigned byte-length 
elements for a particular value. The elements are 
assumed to be arranged in increasing order. 
Clears Carry if it finds the value and sets Carry 
to | if it does not. Returns the address of the 
value if found. The size of the array is specified 
and is a maximum of 255 bytes. 

Procedure: The program performs a binary 
search, repeatedly comparing the value with the 
middle remaining element. After each compari- 
son, the program discards the part of the array 
that cannot contain the value (because of the 
ordering). The program retains upper and lower 
bounds for the remaining part. If the value is 
larger than the middle element, the program 
discards the middle and everything below it. The 
new lower bound is the address of the middle 
element plus |. If the value is smaller than the 
middle element, the program discards the mid- 
dle and everything above it. The new upper 
bound is the address of the middle element 
minus |. The program exits if it finds a match or 
if there is nothing left to search. 

For example, assume that the array is 

O16, 0216, 0516, 0716, 9916, 0916, OD 16, 1016, 

2E 16, 3716, SDi6, TE16, Alig, B4i6, D716, E016 


and the value to be found is 0ODj¢. The proce- 
dure works as follows. 

In the first iteration, the lower bound is the 
base address and the upper bound is the address 
of the last element. So the result is 

LOWER BOUND = BASE 

UPPER BOUND= BASE+ SIZE— |= BASE+ 0Fi¢ 


GUESS = (UPPER BOUND + LOWER BOUND)/2 
(the result is truncated) = BASE + 7 


(GUESS) = ARRAY(7) = 1016 = 16) 

Since the value (OD j¢) is less than ARRAY(7), 
the elements beyond #6 can be discarded. So the 
result is 


SE 


Registers Used: AF, BC, DE, HL 


Execution Time: Approximately 114 cycles per 
iteration plus 53 cycles overhead. A binary search 
requires on the order of log,N iterations, where N is 
the number of elements in the array. 


Program Size: 37 bytes 


Data Memory Required: None 


Special Case: A size of 0 causes an immediate exit 
with the Carry flag set to 1. That is, the array con- 
tains no elements and the value surely cannot be 
found. 





LOWER BOUND = BASE 

UPPER BOUND = GUESS — 1 = BASE+ 6 

GUESS = (UPPER BOUND + LOWER BOUND)/2 
= BASE+ 3 

(GUESS) = ARRAY(3) = 07 


Since the value (0D 1¢) 1s greater than ARRAY(3), 
the elements below #4 can be discarded. So the 
result is 


LOWER BOUND = GUESS + 1 = BASE+ 4 

UPPER BOUND = BASE + 6 

GUESS = (UPPER BOUND + LOWER BOUND)/2 
= BASE+ 5 

(GUESS) = ARRAY(5) = 09 


Since the value (0D j¢) is greater than ARRAY(5), 
the elements below #6 can be discarded. So the 
result is 


LOWER BOUND = GUESS + 1 = BASE + 6 

UPPER BOUND = BASE + 6 

GUESS = (UPPER BOUND + LOWER BOUND)/2 

= 06 

(GUESS) = ARRAY(6) = 0D,« 

Since the value (OD 16) is equal to ARRAY(6), 
the element has been found. If, on the other 
hand, the value were 0Ej¢, the new lower bound 


would be BASE~+ 7 and there would be nothing 
left to search. 
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Entry Conditions 


Value to find in A 

Size of the array in bytes in C 

Base address of array (address of smallest 
unsigned element) in HL 


Examples 


Length of array = 104, 
Elements of array are 0116, 026, 0516, 0716, 09 16.0916, 0Di6, 
1016, 2E 16, 3716, SDy¢, TE16, Alig, B4j6, D715, E01. 


I. Data: Value to find = 0Dj¢ 


Result: Carry = 0, indicating value found 


(HL) = BASE + 6 (address containing 0D}¢) 


“s “8 


° Title Binary search 
; Name: BINSCH 
Purposes Search 
Entrys 
Register C = 
Register A = 
Exits If the value 


Carry flag 


ELSE 
Carry flag 


“3 “9 “8 “~S “8 “AS “we wR WA VS we M8 WB NB OS 


Registers used: AF,BC,DE,HL 


an ordered array of unsigned bytes 
with a maximum size of 255 elements 


Register pair HL = Base address of array 
Size of array 

Byte to find 

is found then 


Register pair HL = Address of value 


Exit Conditions 


Carry = 0 if the value is found; | if it is not 
found. 
If the value is found, (HL) = its address. 


2. Data: Value to find = 9Bi¢ 


Result: Carry = |, indicating value not found 


we “8 “2 “@ wos “VSP VB VSO 


0 


1 


“ue 68 6" NS <n MR OSS WA NS NS WE MEH YER NO 
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Time: Approximately 114 cycles for each iteration of 
the search loop plus 53 cycles overhead 


“ws 6“8 6~e 


A binary search takes on the order of lag 
base 2 of N searches, where N is the number of 
elements in the array. 


~we we up OR UNR UME MER MEH UNS NOR ONE 


<8 “~e wae “8 6S UR UR UO 


Sizes Program 37 bytes 
BINSCH: 
sEXIT WITH CARRY SET IF NO ELEMENTS IN ARRAY 
INC Cc sTEST ARRAY SIZE 
DEC Cc 
SCF sSET CARRY IN CASE SIZE IS 0 
RET Z sRETURN INDICATING VALUE NOT FOUND 


; IF SIZE IS 0 


sINITIALIZE LOWER BOUND, UPPER BOUND OF SEARCH AREA 
;LOQWER BOUND (DE) = BASE ADDRESS 

s;UPPER BOUND (CHL) = ADDRESS OF LAST ELEMENT 

; = BASE ADDRESS + SIZE - 1 


LD E,L ;LOWER BOUND = BASE ADDRESS 
LD D,H 

LD B,O sEXTEND SIZE TO 16 BITS 

ADD HL, BC ;UPPER BOUND = BASE + SIZE - 1 
DEC HL 


7;SAVE VALUE BEING SOUGHT 
LD C,A 7SAVE VALUE 


7; ITERATION QF BINARY SEARCH 

71) COMPARE VALUE TO MIDDLE ELEMENT 

72) IF THEY ARE NOT EQUAL, DISCARD HALF THAT 

; CANNOT POSSIBLY CONTAIN VALUE CBECAUSE OF ORDERING) 
73) CONTINUE IF THERE IS ANYTHING LEFT TO SEARCH 


LOOP: 
s HL UPPER BOUND 
3; DE LOWER BOUND 
3;C = VALUE TQ FIND 
sFIND MIDDLE ELEMENT 
sMIDDLE = (UPPER BOUND + LOWER BOUND) /7 2 


PUSH HL ;SAVE UPPER BOUND ON STACK 

ADD HL, DE ;ADD UPPER BOUND AND LOWER BOUND 
RR H sDIVIDE 17-BIT SUM BY 2 

RR L 

LD A, CHL) ;GET MIDDLE ELEMENT 

;COMPARE MIDDLE ELEMENT AND VALUE 

CP Cc ;COMPARE MIDDLE ELEMENT AND VALUE 
uJIR NC, TOOLRG ;JUMP IF VALUE SAME OR LARGER 


sMIDDLE ELEMENT LESS THAN VALUE 
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; SO CHANGE LOWER BOUND TO MIDDLE + 1 
; SINCE EVERYTHING BELOW MIDDLE IS EVEN SMALLER 


EX DE, HL ;LOWER BOUND = MIDDLE + 1 
INC DE 

POP HL ;RESTORE UPPER BOUND 

JR CONT 


sMIDDLE ELEMENT GREATER THAN OR EQUAL TO VALUE 
; SQ CHANGE UPPER BOUND TO MIDDLE - 1 
? SINCE EVERYTHING ABOVE MIDDLE IS EVEN LARGER 
sEXIT WITH CARRY CLEAR IF VALUE FOUND 


TOOLRG: 
INC SP 7;DISCARD OLD UPPER BOUND FROM STACK 
INC SP 
RET Z 7;IF MIDDLE ELEMENT SAME AS VALUE 
; RETURN WITH CARRY CLEAR 
> AND HL = ADDRESS CONTAINING VALUE 
DEC HL ;UPPER BOUND = MIDDLE - 1 
sCONTINUE IF THERE IS ANYTHING LEFT TO BE SEARCHED 
sNOTHING LEFT WHEN LOWER BOUND ABOVE UPPER BOUND 
CONT: 
LD A,L 7;FORM UPPER BOUND - LOWER BOUND 
CP E ; MUST SAVE BOTH, SOQ USE 8-BIT SUBTRACT 
LD A,H 
SBC A,D 
JR NC, LOOP CONTINUE IF ANYTHING LEFT TO SEARCH 


sNOTHING LEFT TO SEARCH SO COULD NOT FIND VALUE 
7;RETURN WITH CARRY SET (MUST BE OR JR NC WOULD HAVE BRANCHED) 
RET 


38 


SAMPLE EXECUTION 


=u 8 we ve 


SC9Es 
7; SEARCH FOR A VALUE THAT IS IN THE ARRAY 
LD HL, BF ;HL = BASE ADDRESS OF ARRAY 
LD A, (BFSZ) 
LD C,A 7C = ARRAY SIZE IN BYTES 
LO A,7 34 = VALUE TO FIND 
CALL BINSCH 7 SEARCH 


7;CARRY FLAG = 0 (VALUE FOUND) 
7;HL = BF + 4 (ADDRESS OF 7 IN ARRAY) 


;SEARCH FOR A VALUE THAT IS NOT IN THE ARRAY 


LD HL, BF sHL = BASE ADDRESS OF ARRAY 
LD A, (BFSZ) 
LD C,A 7C ARRAY SIZE IN BYTES 


LD A,O 7A VALUE TO FIND 
CALL BINSCH 7 SEARCH 
7;CARRY FLAG = 1 (VALUE NOT FOUND) 


=e ws “Ss “ws “es 


SIZE 
BFSZ: 
BF: 
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sLQQP FOR MORE TESTS 


;SIZE OF ARRAY IN BYTES 
3SIZE OF ARRAY IN BYTES 
7 BUFFER 


Quicksort (QSO})) 


Arranges an array of unsigned word-length 
elements into ascending order using a quicksort 
algorithm. Each iteration selects an element and 
divides the array into two parts, one consisting 
of elements larger than the selected element and 
the other consisting of elements smaller than the 
selected element. Elements equal to the selected 
element may end up in either part. The parts are 
then sorted recursively in the same way. The 
algorithm continues until all parts contain either 
no elements or only one element. An alternative 
is to stop recursion when a part contains few 
enough elements (say, less than 20) to make a 
bubble sort practical. 

The parameters are the array’s base address, 
the address of its last element, and the lowest 
available stack address. The array can thus 
occupy all available memory, as long as there is 
room for the stack. Since the procedures that 
obtain the selected element, compare elements, 
move forward and backward in the array, and 
swap elements are all subroutines, they could be 
changed readily to handle other types of elements. 

Ideally, quicksort should divide the array in 
half during each iteration. How closely the 
procedure approaches this ideal depends on 
how well the selected element is chosen. Since 
this element serves as a midpoint or pivot, the 
best choice would be the central value (or 
median). Of course, the true median is unknown. 
A simple but reasonable approximation is to 
select the median of the first, middle, and last 
elements. 


Procedure: The program first deals with the 
entire array. It selects the median of the current 
first, last, and middle elements to use in dividing 
the array. It moves that element to the first 
position and divides the array into two parts or 
partitions. It then operates recursively on the 
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Registers Used: AF, BC, DE, HL 


Execution Time: Approximately N * log,N loops 
through PARTLP plus 2 * N + 1 overhead calls 
to SORT. Each iteration of PARTLP takes approx- 
imately 200 cycles and each overhead call to SORT 
takes approximately 300 cycles. Thus, the total 
execution time is on the order of 200 * N * log,N + 300 
*(2* N+ 1). 


Program Size: 206 bytes 


Data Memory Required: 8 bytes anywhere in 
RAM for pointers to the first and last elements of a 
partition (2 bytes starting at addresses FIRST and 
LAST, respectively), a pointer to the bottom of the 
stack (2 bytes starting at address STK BTM), and the 
original value of the stack pointer (2 bytes starting at 
address OLDSP). 


Special Case: If the stack overflows (i.e., comes 
too close to its boundary), the program exits with 
the Carry flag set to 1. 


parts, dividing them further into parts and stop- 
ping when a part contains no elements or only 
one element. Since each recursion places six 
bytes on the stack, the program must guard 
against stack overflow by checking whether the 
stack has grown to within a small buffer of its 
lowest available address. 

Note that the selected element always ends up 
in the correct position after an iteration. There- 
fore, it need not be included in either partition. 

The rules for choosing the middle element are 
as follows, assuming that the first element is #1: 


1. If the array has an odd number of ele- 
ments, take the one in the center. For example, 
if the array has 11 elements, take #6. 


2. If the array has an even number of ele- 
ments and its base address is even, take the 
element on the lower (base address) side of the 
center. For example, if the array starts in 0300j¢ 
and has 12 elements, take #6. 


3. If the array has an even number of ele- 


ments and its base address is odd, take the 
element on the upper side of the center. For 
example, if the array starts in 03016 and has 12 
elements, take #7. 


Entry Conditions 


Base address of array in HL 
Address of last word of array in DE 
Lowest available stack address in BC 


Example 


l. 


Data: 


Result: 


Length (size) of array = 0Cj¢ 
Elements = 2By65 D1 46; 1Di6, 26165 
1716, 4By6, 3716, 2716 


The result of the first iteration is: 


Selected element = median of the first 
(#1 = 2B,.¢), middle (#6 = 2E,¢), and last 
(#12 = 27,6) elements. The selected ele- 
ment is therefore #1 (2B,¢), and no swap- 
ping is necessary since it is already in the 
first position. 


At the end of the iteration, the array is 


2E 16, 4Bie, 3716 5716. 


The first partition, consisting of elements 
less than 2Bi6, iS 2146; 17165 1Di¢, 26165 22165 
and 0Ci¢. 

The second partition, consisting of ele- 
ments greater than 2By¢, is 446, 2Ej¢, 4Bi¢, 
Shi and 57 16: 

Note that the selected element (2Bj¢) is 
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Exit Conditions 


Array sorted into ascending order, considering 
the elements as unsigned words. Thus, the 
smallest unsigned word ends up Stored starting 
at the base address. Carry = 0 if the stack did 
not overflow and the result is proper. Carry = | 
if the stack overflowed and the final array is 
not sorted. 


now in the correct position and need not be 
included in either partition. 

The first partition may now be sorted recur- 
sively in the same way: 


Selected element = median of the first 
(#1 = 27,6), middle (#3 = 1Dj¢), and last 
(#7 = OCj¢) elements. Here, #4 is the 
median and must be exchanged initially 
with #1. 


The final order of the elements in the first 
partition is 


OC e171 Dig, 26je, 2215, Dive 


The first partition of the first partition 
(consisting of elements less than 1Dj,¢) is 
OC1¢, 17,6. This will be referred to as the (1,1) 
partition. 

The second partition of the first partition 
(consisting of elements greater than 1Dj¢) is 
26165 22165 and 27 16- 

As in the first iteration, the selected ele- 
ment (1Dj,¢) is in the correct position and 
need not be considered further. 
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The (1,1) partition may now be sorted same method. Obviously, quicksort’s over- 
recursively as follows: head is large when the number of elements is 
small. This is why one might use a bubble 
Selected element = median of the first sort once quicksort has created small enough 
(#1 = OC,¢), middle (#1 = OC,,¢), and last partitions. 
(#2 = 17,6) elements. Thus the selected ele- Note that the example array does not con- 
ment is the first element (#1 = 0C,¢) and no tain any identical elements. During an itera- 
initial swap is necessary. tion, elements that are the same as the 
selected element are never moved. Thus they 
The final order is obviously the same as the may end up in either partition. Strictly speak- 
initial order, and the two resulting partitions ing, then, the two partitions consist of ele- 
contain 0 and | elements, respectively. Thus ments “less than or possibly equal to the 
the next iteration concludes the recursion, selected element” and elements “greater than 
and the other partitions are sorted by the or possibly equal to the selected element.” 
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; ; 
? ; 
; Title | Quicksort ; 
; Name: QSORT : 
; ; 
; Purpose: Arrange an array of unsigned words into : 
; ascending order using quicksort, with a : 
; maximum size of 32,767 words ; 
; Entrys Register pair HL = Address of first word in the ; 
; array : 
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Register pair DE Address of last ward in the 


array 
Register pair BC = Lowest available stack 
address 
Exits If the stack did not oaverflaw then 


array is sorted into ascending order. 
Carry flag = O 

Else 
Carry flag = 1 


Registers used: AF,BC, DE, HL 


Times The timing is highly data-dependent but the 
quicksort algorithm takes approximately 
N * lag (N) loops through PARTLP. There will be 
2 * Nti calls to Sort. The number of recursions 
will probably be a fraction of N but if all 
data is the same, the recursion could be up to 
N. Therefore the amount of stack space should 
be maximized. NOTE: Each recursion level takes 
6 bytes of stack space. 


In the above discussion N is the number of 
array elements. 


For example, sorting a 16,384-word array took 
about 27 seconds and 1200 bytes of stack space 
on a 6 MHz Z8O. 


Sizes Program 206 bytes 
Data 8 bytes 


“us 6s 68 ws We we 48 NS 4s V8 NS MB ONS 6A ME ONE NS USS MSs 6S OVS SS NS SS VE WS NE SNE ONS WS NES OME WS WS 
~we = 6we MS MS NS we ws eR M8 Ne NB Se SE =e we 68 6408 68 UNS WS UNS CR wR ee 88 WS MS WS Ve ME ES WSR WE 


QSORT: 
sWATCH FOR STACK OVERFLOW 
s;CALCULATE A THRESHOLD TO WARN OF OVERFLOW 
: (10 BYTES FROM THE END OF THE STACK) 
7;SAVE THIS THRESHOLD FOR LATER COMPARISONS 
,ALSO SAVE THE POSITION OF THIS ROUTINE’S RETURN ADDRESS 
; IN THE EVENT WE MUST ABORT BECAUSE OF STACK OVERFLOW 


PUSH HL 7;SAVE BASE ADDRESS OF ARRAY 
LD HL, 10 7;ADD SMALL BUFFER (10 BYTES) TO 
ADD HL, BC ; LOWEST STACK ADDRESS 
LD (STKBTM),HL s;SAVE SUM AS BOTTOM OF STACK 
; FOR FIGURING WHEN TO ABORT 
LD HL, 2 s;SAVE POINTER TQ RETURN ADDRESS 
ADD HL, SP ; IN CASE GF ABORT 
LD (OLDSP),HL 
POP HL s;RESTORE BASE ADDRESS 


;WORK RECURSIVELY THROUGH THE QUICKSORT ALGORITHM AS 
; FOLLOWS: 
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SORT: 


PARTION: 


1. CHECK IF THE PARTITION CONTAINS O OR 1 ELEMENT. 

MOVE UP A RECURSION LEVEL IF IT DOES. 

USE MEDIAN TO OBTAIN A REASONABLE CENTRAL VALUE 

FOR DIVIDING THE CURRENT PARTITION INTO TWO 

PARTS. 

3. MOVE THROUGH ARRAY SWAPPING ELEMENTS THAT 
ARE OUT OF ORDER UNTIL ALL ELEMENTS BELOW THE 

CENTRAL VALUE ARE AHEAD OF ALL ELEMENTS ABOVE 
THE CENTRAL VALUE. SUBROUTINE COMPARE 
COMPARES ELEMENTS, SWAP EXCHANGES ELEMENTS, 
PREV MQVES UPPER BOUNDARY DOWN ONE ELEMENT, 
AND NEXT MOVES LOWER BOUNDARY UP ONE ELEMENT. 

4. CHECK IF THE STACK IS ABOUT TO OVERFLOW. IF IT 
IS, ABORT AND EXIT. 

S. ESTABLISH THE BOUNDARIES FOR THE FIRST PARTITION 
CCONSISTING OF ELEMENTS LESS THAN THE CENTRAL VALUE) 
AND SORT IT RECURSIVELY. 

6. ESTABLISH THE BOUNDARIES FOR THE SECOND PARTITION 
CCONSISTING OF ELEMENTS GREATER THAN THE CENTRAL 
VALUE) AND SORT IT RECURSIVELY. 


we “we 6S SSH OS 
a 


36 “6 


en a i tn ee ed 


7SAVE BASE ADDRESS AND FINAL ADDRESS IN LOCAL STORAGE 


LD (FIRST), HL. 3SAVE FIRST IN LOCAL AREA 
EX DE, HL 
LD (LAST) ,HL 3;SAVE LAST IN LOCAL AREA 


sCHECK IF PARTITION CONTAINS O OR 1 ELEMENTS 
+ IT DOES IF FIRST IS EITHER LARGER THAN (0) 
; OR EQUAL TO (1) LAST. 


?STOP WHEN FIRST >= LAST 
7;DE = ADDRESS OF FIRST 
7;HL = ADDRESS OF LAST 


LD A,E s;CALCULATE FIRST - LAST ' 

SUB L ; MUST KEEP BOTH, SO USE 8-BIT SUBTRACT 
LD A,D 

SBC A,H 

RET NC IF DIFFERENCE POSITIVE, RETURN 


; THIS PART IS SORTED 


;USE MEDIAN TO FIND A REASONABLE CENTRAL (PIVOT) ELEMENT 
;MOVE CENTRAL ELEMENT TO FIRST POSITION 


CALL MEDIAN s;SELECT CENTRAL ELEMENT, MOVE IT 
7; TO FIRST POSITION 
LD C,o | 7;BIT O OF REGISTER C = DIRECTION 


> IF IT’S O THEN DIRECTION IS UP 
; ELSE DIRECTION IS DOWN 


7;REORDER ARRAY BY COMPARING OTHER ELEMENTS WITH 

CENTRAL ELEMENT. START BY COMPARING THAT ELEMENT WITH 
LAST ELEMENT. EACH TIME WE FIND AN ELEMENT THAT 
BELONGS IN THE FIRST PART (THAT IS, IT IS LESS THAN 

THE CENTRAL ELEMENT), SWAP IT INTO THE FIRST PART IF IT 


=e ~8 “8 we 


PARTLP: 


UP s 
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IS NOT ALREADY THERE AND MOVE THE BOUNDARY OF THE 

FIRST PART DOWN ONE ELEMENT. SIMILARLY, EACH TIME WE 
FIND AN ELEMENT THAT BELONGS IN THE SECOND PART (THAT 
Is, IT IS GREATER THAN THE CENTRAL ELEMENT), SWAP IT INTO 
THE SECOND PART IF IT IS NOT ALREADY THERE AND MOVE 

THE BOUNDARY OF THE SECOND PART UP ONE ELEMENT. 
ULTIMATELY, THE BOUNDARIES COME TOGETHER 

AND THE DIVISION OF THE ARRAY IS THEN COMPLETE 
s;NOTE THAT ELEMENTS EQUAL TO THE CENTRAL ELEMENT ARE NEVER 
; SWAPPED AND SO MAY END UP IN EITHER PART 


wes “8s “68 ve SSB «8 


bd 


s;LQOOP SORTING UNEXAMINED PART OF THE PARTITION 
3 UNTIL THERE IS NOTHING LEFT IN IT 


Lo A,E ;LOWER BOUNDARY —- UPPER BOUNDARY 

SUB L ; MUST KEEP BOTH, SO USE 8-BIT SUBTRACT 
LD A,D 

SBC A,H 

JR NC, DONE sEXIT WHEN EVERYTHING EXAMINED 


sCOMPARE NEXT 2 ELEMENTS. IF OUT OF ORDER, SWAP THEM 
AND CHANGE DIRECTION OF SEARCH 
> IF FIRST > LAST THEN SWAP 


CALL COMPARE 7 COMPARE ELEMENTS 

JR C,OK ;JUMP IF ALREADY IN ORDER 
JR Z,OK ; OF IF ELEMENTS EQUAL 
s;ELEMENTS OUT OF ORDER. SWAP THEM 

CALL SWAP 7SWAP ELEMENTS 

INC C 7CHANGE DIRECTION 


7;REDUCE SIZE OF UNEXAMINED AREA 

7IF NEW ELEMENT LESS THAN CENTRAL ELEMENT, MOVE 

; TOP BOUNDARY DOWN 

3IF NEW ELEMENT GREATER THAN CENTRAL ELEMENT, MOVE 
; BOTTOM BOUNDARY UP 

7;IF ELEMENTS EQUAL, CONTINUE IN LATEST DIRECTION 


BIT 0,C s;BIT O OF C TELLS WHICH WAY TO GO 
JR Z,UP ;JUMP IF MOVING LP 
EX DE, HL 
CALL NEXT ;ELSE MOVE TOP BOUNDARY DOWN BY 
EX DE, HL ; ONE ELEMENT 
JR PARTLP 
CALL PREV 7;MQVE BOTTOM BOUNDARY UP BY 
; ONE ELEMENT 


JR PARTLP 


;THIS PARTITION HAS NOW BEEN SUBDIVIDED INTO TWO 
PARTITIONS. ONE STARTS AT THE TOP AND ENDS JUST 
ABOVE THE CENTRAL ELEMENT. THE OTHER STARTS 
JUST BELOW THE CENTRAL ELEMENT AND CONTINUES 

TO THE BOTTOM. THE CENTRAL ELEMENT IS NOW IN 
ITS PROPER SORTED POSITION AND NEED NOT BE 
INCLUDED IN EITHER PARTITION 


“=B “8 6A 


<8 “8 ~<A 
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DONE : 


ABORT: 


MEDIAN: 


s;FIRST CHECK WHETHER STACK MIGHT OVERFLOW 
;IF IT IS GETTING TOO CLOSE TO THE BOTTOM, ABORT 
; THE PROGRAM AND EXIT 


LD HL, (STKBTM) s;CALCULATE STKBTM —- SP 
OR A ;CLEAR CARRY 

SBC HL, SP 

JR NC, ABORT sEXIT IF STACK TOO LARGE 


s;ESTABLISH BOUNDARIES FOR FIRST (LOWER) PARTITION 
;LQWER BOUNDARY IS SAME AS BEFORE 

;UPPER BOUNDARY IS ELEMENT JUST BELOW CENTRAL ELEMENT 
7 THEN RECURSIVELY QUICKSORT FIRST PARTITION 


PUSH DE *SAVE ADDRESS OF CENTRAL ELEMENT 
LD HL, (LAST) 

PUSH HL. SAVE ADDRESS OF LAST 

EX DE, HL 

CALL PREV s;CALCULATE LAST FOR FIRST PART 
EX DE, HL 

LD HL, (FIRST) ;FIRST IS SAME AS BEFORE 

CALL SORT s;QUICKSORT FIRST PART 


s;ESTABLISH BOUNDARIES FOR SECOND (UPPER) PARTITION 
;UPPER BOUNDARY IS SAME AS BEFORE 

7LOWER BOUNDARY IS ELEMENT JUST ABOVE CENTRAL ELEMENT 
7THEN RECURSIVELY QUICKSORT SECOND PARTITION 


POP DE s;LAST IS SAME AS BEFORE 

POP HL. CALCULATE FIRST FOR SECOND PART 

CALL NEXT 

CALL SORT ;QUICKSORT SECOND PART 

OR A s;CARRY = 0 FOR NO ERRORS 

RET 

;ERROR EXIT — SET CARRY 

LD SP, COLDSP) ;TOP OF STACK IS ORIGINAL 
; RETURN ADDRESS 

SCF s INDICATE ERROR IN SORT 

RET ;RETURN TO ORIGINAL CALLER 


b REESE RE REESE HEE IE IE IE AE IEE SE FE HE FE HE HE OE HE aE HE BE BE HE TE 

;ROUTINE: MEDIAN 

7;PURPOSE: DETERMINE WHICH VALUE IN A PARTITION 

; SHOULD BE USED AS THE CENTRAL ELEMENT OR PIVOT 
7;ENTRY: DE = ADDRESS OF FIRST VALUE 

; HL = ADDRESS OF LAST VALUE 

sEXIT: DE IS ADDRESS OF CENTRAL ELEMENT 

s;REGISTERS USED: AF,BC, DE 

$ SEE RE HE SE FE BE IE HE HE HE BE HE SE FE HE IE BE BE IE EH UE HE a HE HE HE HE 


DETERMINE ADDRESS OF MIDDLE ELEMENT 

; MIDDLE := ALIGNED (FIRST + LAST) DIV 2 

LD A,L ;ADD ADDRESSES OF FIRST, LAST 
ADD A,E s;MUST KEEP BOTH, SO USE S-BIT 
LD C,A ; ADD INSTEAD OF 16-BIT 


MEDI: 


MIDD1is 


BIT 
JR 
INC 


Port 


= MC} 


«< ~< =< 


ED1 


ONOONDwWHDyY 
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;DIVIDE SUM BY 2, BYTE AT A TIME 


sCLEAR BIT O FOR ALIGNMENT 

sALIGN MIDDLE TQ BOUNDARY OF FIRST 
; JUMP IF BIT O OF FIRST IS O 

; ELSE MAKE BIT O OF MIDDLE 1 


;DETERMINE WHICH OF FIRST, MIDDLE, LAST IS 


; MEDIAN (CENTRAL VALUE) 


7COMPARE FIRST AND MIDDLE 


PUSH 
LD 
LD 
CALL 
POP 
JR 


HL 

L,C 

H,B 
COMPARE 
HL 
NC,MIDD1 


7 SAVE LAST 


;COMPARE FIRST AND MIDDLE 
;RESTORE LAST 
;JUMP IF FIRST >= MIDDLE 


;WE KNOW (MIDDLE > FIRST) 
; SQ COMPARE MIDDLE AND LAST 


PUSH 
LD 
LD 
CALL 
POP 
JR 
JR 


DE 

E,C 

D,B 
COMPARE 
DE 

C, SWAPMF 
Z, SWAPMF 


sSAVE FIRST 


7;COMPARE MIDDLE AND LAST 
;RESTORE LAST 

;JUMP IF LAST >= MIDDLE 
; MIDDLE IS MEDIAN 


;WE KNOW (MIDDLE > FIRST) AND (MIDDLE > LAST) 
; SO COMPARE FIRST AND LAST 


CALL 
RET 


JR 


COMPARE 
NC 


SWAPLF 


;COMPARE FIRST AND LAST 
s;RETURN IF LAST >= FIRST 
; FIRST IS MEDIAN 

s;ELSE LAST IS MEDIAN 


;WE KNOW CFIRST >= MIDDLE) 
; SO COMPARE FIRST AND LAST 


CALL 
RET 
RET 


COMPARE 
Cc 
Z 


7COMPARE LAST AND FIRST 
s;RETURN IF LAST >= FIRST 
; FIRST IS MEDIAN 


;WE KNOW (FIRST >= MIDDLE) AND (FIRST > LAST) 


: SO COMPARE MIDDLE AND 


PUSH 
LD 
LD 
CALL 
POP 
JR 


DE 

E,C 

D,B 
COMPARE 
DE 

C, SWAPLF 


LAST 


s;SAVE FIRST 
7DE = MIDDLE 


7COMPARE MIDDLE AND LAST 
;RESTORE FIRST 

;JUMP IF LAST > MIDDLE 

; LAST IS MEDIAN 
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SWAPMF : 


SWAPLF = 


NEXT: 


PREV: 


;MIDDLE IS MEDIAN, SWAP IT WITH FIRST 


PUSH HL ;SAVE LAST 

LO L,Cc yHL = ADDRESS QF MIDDLE 
LD H,B 

CALL SWAP s;SWAP MIDDLE, FIRST 
POP HL s;RESTORE LAST 

RET 

sLAST IS MEDIAN, SWAP IT WITH FIRST 

CALL SWAP ;SWAP FIRST AND LAST 
RET 


7 RUMEN KCRARKRARKARKKRRKRRRAR ARR RR 
;ROUTINE: NEXT 

;PURPOSE: MAKE HL POINT TQ NEXT ELEMENT 
s;ENTRY: HL = ADDRESS OF CURRENT ELEMENT 
7EXIT: HL = ADDRESS OF NEXT ELEMENT 
7REGISTERS USED: HL 

9 HEHE 06 HEE E28 98 9b 96 9E HE 9 EE IE TE HE IE HE HE IE IE IEE EEE 


INC HL 3 INCREMENT TO NEXT ELEMENT 
INC HL 
RET 


9 MERE 9 9S 9S Ee He HE I HE EE IE I HE IE IE HE IE HEE EE EEE 
;ROUTINE: PREV 

;PURPOSE: MAKE HL POINT TO PREVIOUS ELEMENT 
sENTRY: HL = ADDRESS OF CURRENT ELEMENT 
sEXIT: HL = ADDRESS OF PREVIOUS ELEMENT 
7;REGISTERS USED: HL 

p POE IG IE IE 9G DE DE 36 96 96 98 9S FE NE 9 IE FE IE NE HE 98 9 9S IE BE 2 BE OE EE 


DEC HL. s;DECREMENT TO PREVIOUS ELEMENT 
DEC HL 
RET 


} RNCRRARKRARKKRKKKKKRRARKHHRRR RHR 

;ROUTINE: COMPARE 

;PURPOSE: COMPARE DATA ITEMS POINTED TO BY DE AND HL 
s;ENTRY: DE = ADDRESS OF DATA ELEMENT 1 

? HL = ADDRESS OF DATA ELEMENT 2 

sEXIT: IF ELEMENT 1 > ELEMENT 2 THEN 


? c=0 
7 Z=0 
; IF ELEMENT 1 < ELEMENT 2 THEN 
; Cc = 1 
; Z=0 
; IF ELEMENT 1 = ELEMENT 2 THEN 
; Cc =0 
; Z= 1 


;REGISTERS USED: AF 
} RUMMAMRAKAHKKKKRRARKR RAK AKG HHH 


COMPARE = 


SWAF': 


FIRST: 
LAST: 
STKBTM: 
QLOSP: 


26 6“8 “VS ME OWS 


INC 
INC 
LD 
CP 
DEC 
DEC 
RET 
LD 
cP 
RET 
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7;POINT TQ HIGH BYTES 
7;COMPARE HIGH BYTES 
;PQOINT TO LOW BYTES 


s;RETURN IF HIGH BYTES NOT EQUAL 
;OTHERWISE, COMPARE LOW BYTES 


} RREKKHRHKKKKRKERRKKKKRRRKKKH GRRE KK 
sROQUTINE: SWAP 


7 PURPQSE: 
7 ENTRY: 


sEXIT: 


SWAP ELEMENTS POINTED TO BY DE,HL 


DE = ADDRESS OF ELEMENT 1 
HL = ADDRESS OF ELEMENT 2 


ELEMENTS SWAPPED 


7REGISTERS USED: 
} RHNHMKHKAKRKRRKAKKKRKKKKR KE RRR 


7;SWAP LOW BYTES 


LD B, CHL) 
LD A, (DE) 
LD CHL),A 
LD A,B 
LD (DE),A 
INC HL 

INC DE 
7;SWAP HIGH BYTES 
LD B, CHL) 
LD A, (DE) 
LD CHL),A 
LD A,B 

LD (DE),A 
DEC HL 

DEC DE 
RET 


DATA SECTION 


DS 
DS 
DS 
DS 


bd WO POD 


SAMPLE EXECUTION: 


7;GET ELEMENT 2 
7;GET ELEMENT 1 
7;STORE NEW ELEMENT 2 


s;STORE NEW ELEMENT 1 


;GET ELEMENT 2 
7;GET ELEMENT 1 
;STORE NEW ELEMENT 2 


STORE NEW ELEMENT 1 


sPOINTER TO FIRST ELEMENT OF PART 
s;POINTER TO LAST ELEMENT OF PART 

s THRESHOLD FOR STACK OVERFLOW 
s;POINTER TO ORIGINAL RETURN ADDRESS 


we “8 “8 “WS ws 
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SCOF = 


BEGBUF : 


ENDBUF : 


7;SORT AN ARRAY BETWEEN BEGBUF (FIRST ELEMENT) 
; AND ENDBUF CLAST ELEMENT) 
sSTART STACK AT S000 HEX AND ALLOW IT TO EXPAND 
; AS FAR AS 4F00 HEX 
LD SP, 5000H 3;SET UP A STACK AREA 
LD BC, 4F00H ;BC = LOWEST AVAILABLE STACK ADDRESS 
LD HL, BEGBUF sHL = ADDRESS OF FIRST ELEMENT OF ARRAY 
LD DE, ENDBUF 7;DE = ADDRESS OF LAST ELEMENT OF ARRAY 
CALL QSORT ; SORT 
. s;RESULT FOR TEST DATA IS 
— 0,1,2,3, woe 714,15 
JR SCOF ;LOOP FOR MORE TESTS 
7;DATA SECTION 
DW 15 
DW 14 
DW 13 
DW 12 
DW 11 
DW 10 
DW 9 
DW 3 
DW 7 
DW 6 
DW 2 
DW 4 
Dw 3 
DW 2 
DW 1 
DW 0 


RAM Test (2AMIST) 


Testsa RAM area specified by a base address 
and a length in bytes. Writes the values 0, FF 6, 
AAj6 (101010102), and 551¢ (010101014) into each 
byte and checks whether they can be read back 
correctly. Places 1 in each bit position of each 
byte and checks whether it can be read back 
correctly with all other bits cleared. Clears the 
Carry flag if all tests run properly. If it finds an 
error, it exits immediately, setting the Carry flag 
and returning the test value and the address at 
which the error occurred. 

Procedure: The program performs the single 
value checks (with 0, FFj¢, AAj6, and 55)¢) by 
first filling the memory area and then comparing 
each byte with the specified value. Filling the 
entire area first should provide enough delay 
between writing and reading to detect a failure 
to retain data (perhaps caused by improperly 
designed refresh circuitry). The program then 
performs the walking bit test, starting with bit 7; 


Entry Conditions 


Base address of test area in HL 
Size of test area in bytes in DE 


Example 


I. Data: Base address = 03801, 


Length (size) of area = 0200 ¢ 


YS 


Registers Used: AF, BC, DE, HL 


Execution Time: Approximately 633 cycles per 
byte tested plus 663 cycles overhead 


Program Size: 82 bytes 
Data Memory Required: None 


Special Cases: 


I. An area size of 0000,, causes an immediate 
exit with no memory tested. The Carry flag is 
cleared to indicate no errors. 


2. Since the routine changes all bytes in the 
tested area, using it to test an area that includes 
itself will have unpredictable results. 

Note that Case | means this routine cannot be 
asked to test the entire memory. Such a request 
would be meaningless anyway since it would re- 
quire the routine to test itself. 


3. Testing a ROM causes a return with an error 
indication after the first occasion on which the test 
value differs from the memory’s contents. 





here it writes the data into memory and attempts 
to read it back immediately for a comparison. 


Exit Conditions 


If an error is found: 
Carry = | 
Address containing error in HL 
Test value in A 
If no error is found: 
Carry = 0 
All bytes in test area contain 0 


Result: Area tested is the 0200,,¢ bytes starting at 
address 0380,,¢, that is, addresses 0380i¢ 


through 057F,,. The order of the tests is 
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“~8 6“8 w8 “SB UNS A 


“se ss 


“ws 6 “e@ “wae 6SS “NS US ME ME UMS UNS UNS UNS UMS OME WS UMS MR ONE 


at it i i i ee) i) | eT 


“68 


“=e “Ge WO NS MA 


. Write and read 0 


WM Bb WN = 


. Write and read FFj¢ 

. Write and read AAj¢ (101010105) 

. Write and read 55,¢ (01010101,) 

. Walking bit test, starting with | in 


bit 7. That is, start with 10000000, 
(80,¢) and move the | one position 
right for each subsequent test of a 


byte. 


Title 
Name: 


Purposes 


Entry: 


Exits 


Registers used: 


Times 


Sizes 


RAM test 
RAMTST 


Test a RAM (read/write memory) area 
1) Write all O and test 
2) Write all FF hex and test 
3) Write all AA hex and test 
4) Write all S5 hex and test 
2) Shift a single 1 through each bit, 
while clearing all other bits 


If the program finds an error, it exits 
immediately with the Carry flag set and 
indicates where the error occurred and 
what value it used in the test. 


Register pair HL = Base address of test area 
Register pair DE = Size of area in bytes 


If there are no errors then 
Carry flag = 0 
test area contains O in all bytes 
else 
Carry flag = 1 
Register pair HL = Address of error 
Register A = Expected value 


AF, BC, DE.HL 


Approximately 633 cycles per byte plus 
663 cycles overhead 


Program S2 bytes 


ws “8s wR “ea NB UB UNE USA 


we we we we wS we we Ve we NS 48 NS We MS Me ue M8 VR YS WR NS ME ME NER NS MS M2 NB OMB NER NE NS NS 


RAMTSTs: 


WLKELP: 


WLKLPF 1 = 


9G RAMTEST(RAMIST) 349 


sEXIT WITH NO ERRORS IF AREA SIZE IS O 


LD A,D TEST AREA SIZE 

QR E 

RET Z s;EXIT WITH NO ERRORS IF SIZE IS ZERO 
LD B,D 7BC = AREA SIZE 

LD C,E 

7;FILL MEMORY WITH O AND TEST 

SUB A 

CALL FILCMP 

RET Cc s;EXIT IF ERROR FOUND 
;FILL MEMORY WITH FF HEX CALL 1°S) AND TEST 
LD A, OFFH 

CALL FILCMP 

RET C 7;EXIT IF ERROR FOUND 


7;FILL MEMORY WITH AA HEX (ALTERNATING 1°S AND 0°S) AND TEST 
LD A, OAAH 

CALL FILCMP 

RET C sEXIT IF ERROR FOUND 


;FILL MEMORY WITH SS HEX (ALTERNATING 0°S AND 1°S) AND TEST 
LD A, 35H 

CALL FILCMP 

RET C 7;EXIT IF ERROR FOUND 


7;PERFORM WALKING BIT TEST. PLACE A 1 IN BIT 7 AND 
SEE IF IT CAN BE READ BACK. THEN MOVE THE 1 TO 
BITS 6, 3, 4, 3, 2, 1, AND O AND SEE IF IT CAN 
BE READ BACK 


“wa 6S 6B 


LD A, 1O000000B ;MAKE BIT 7 1, ALL OTHER BITS O 

LD CHL), A STORE TEST PATTERN IN MEMORY 

CP CHL) 7 TRY TO READ IT BACK 

SCF 7;SET CARRY IN CASE OF ERROR 

RET NZ RETURN IF ERROR 

RRCA s;ROTATE PATTERN TO MOVE 1 RIGHT 

CP 10000000B 

IR NZ,WLKLP 1 7;CONTINUE UNTIL 1 IS BACK IN BIT 7 
LD CHL),9O s;CLEAR BYTE JUST CHECKED 

INC HL 

DEC BC 7DECREMENT AND TEST 16-BIT COUNTER 
LD A,B 

OR Cc 

JR NZ,WLKLP ;CONTINUE UNTIL MEMORY TESTED 

RET 7NOQ ERRORS (NOTE OR C CLEARS CARRY) 


g MISSES SEE TE EE IE IS EE EE EE EE EE EE 
;ROQUTINE: FILCMP 

;PURPOSE: FILL MEMORY WITH A VALUE AND TEST 
; THAT IT CAN BE READ BACK 
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m 
< 
al 
~ 


ot i) Mie) | eS eT ee eT et eS ee 


FILCMP: 

PUSH 
PUSH 
LD 
LD 
DEC 
LD 
QR 
LD 
JR 


ENTRY: 


A = TEST VALUE 
BASE ADDRESS 
SIZE OF AREA IN BYTES 


HL 
BC 


IF NO ERRORS THEN 
CARRY FLAG I5 0 


ELSE 


CARRY FLAG 
HL = ADDRESS 
BASE ADDRESS 

SIZE OF AREA IN BYTES 
A = TEST VALUE 

REGISTERS USED: AF, BC, DE, HL 

SE95 0 FE OE FE SE SE Se OG EE EE RE EI HE HE HE HE HE HE 2 HE 9 3 2 2 9 ETE TEE 


DE 
BC 


HL 

BC 

E,A 
CHL),A 

BC 

A,B 

Cc 

A,E 

Z, COMPARE 


Is 1 
OF ERROR 


7;SAVE BASE ADDRESS 

3;SAVE SIZE OF AREA 

7;SAVE TEST VALUE 

7;STORE TEST VALUE IN FIRST BYTE 
;REMAINING AREA = SIZE —- 1 

s;CHECK IF ANYTHING IN REMAINING AREA 


7RESTORE TEST VALUE 
+ BRANCH IF AREA WAS QNLY 1 BYTE 


;FILL REST QF AREA USING BLOCK MOVE 
3 EACH ITERATION MQVES TEST VALUE TQ NEXT HIGHER ADDRESS 


LD 
LD 
INC 
LDIR 


D,H 
E,L 
DE 


7DESTINATION IS ALWAYS SOURCE + 1 


;FILL MEMORY 


NOW THAT MEMORY HAS BEEN FILLED, TEST TQ SEE IF 


; EACH BYTE CAN BE READ 


COMPARE: 
PoP 
POP 
PUSH 
PUSH 


BC 
HL 
HL 
BC 


BACK CORRECTLY 


;RESTORE SIZE OF AREA 
;RESTORE BASE ADDRESS 
7SAVE BASE ADDRESS 
7;SAVE SIZE OF VALUE 


;COMPARE MEMORY AND TEST VALUE 


CMPLF: 
CPI 
IR 
JF 


NZ, CMPER 
PE, CMPLP 


7NQ ERRORS FOUND, 


POP 
POP 
OR 

RET 


7;ERROR EXIT, SET CARRY 
7;HL = ADDRESS OF ERROR 


BC 
HL 
A 


7A = TEST VALUE 


3JUMP IF NOT EQUAL 

7CONTINUE THROUGH ENTIRE AREA 

7 NOTE CPI CLEARS P/V FLAG IF IT 
; DECREMENTS BC TO 0 


SQ CLEAR CARRY 


7BC = SIZE OF AREA . 
7;HL = BASE ADDRESS 
s;CLEAR CARRY, INDICATING NO ERRORS 
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CMPER: 
PaP BC sDE = SIZE OF AREA 
POP DE :BC = BASE ADDRESS 
Sa 3SET CARRY, INDICATING AN ERROR 


“6 “8B 6S 


SAMPLE EXECUTION 


we 48 “8S SH SS 
<—s “Be 


if) 
7 
Oo 
9) 
an 


TEST RAM FROM 2000 HEX THROUGH SOOF HEX 
; SIZE OF AREA = 1010 HEX BYTES 


LO HL, 2000H ;HL = BASE ADDRESS 
LD DE, 1010H 7;DE = NUMBER OF BYTES 
CALL RAMTST TEST MEMORY 


s;CARRY FLAG SHOULD BE O 


mi 
in 
m 
a) 
a 


;LOOP FOR MORE TESTING 


END 


Jump Table (JTA8) 


Transfers control to an address selected from 
a table according to an index. The addresses are 
stored in the usual Z80 format (less significant 
byte first), starting at address JMPTAB. The 
size of the table (number of addresses) is a 
constant, LENSUB, which must be less than or 
equal to 128. If the index is greater than or equal 
to LENSUB, the program returns control imme- 
diately with the Carry flag set to 1. 

Procedure: The program first checks if the 
index is greater than or equal to the size of the 
table (LENSUB). If it is, the program returns 
control with the Carry flag set. If it is not, the 
program obtains the starting address of the 
appropriate subroutine from the table and jumps 
to it. 


Eniry Conditions 


Index in A 


Example 


l. Data: LENSUB (size of subroutine table) = 03 
Table consists of addresses SUBO, SUBI, 
and SUB2. 
Index = (A) = 02 
Result: Control transferred to address SUB2 


(PC = SUB2) 
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9H 


Registers Used: AF 


Execution Time: 117 cycles overhead, besides the 
time required to execute the actual subroutine 


Program Size: 21 bytes plus 2 * LENSUB bytes for 
the table of starting addresses, where LENSUB is the 
number of subroutines 


Data Memory Required: None 
Special Case: Entry with an index greater than or 


equal to LENSUB causes an immediate exit with 
the Carry flag set to 1. 





Exit Conditions 


If (A) is greater than LENSUB, an immediate 
return with Carry = 1. Otherwise, control is 
transferred to the appropriate subroutine as if 
an indexed call had been performed. The return 
address remains at the top of the stack. 
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“we “Ss ~wes “ws “ws ws “Se we 
“Se “ese ve “8S wa we we “Se 


Title Jump table 
Name: JTAB 
Purposes Given an index, jump ta the subroutine with 


that index in a table. 


“we 6“8@ “SB NS OB 


Entry: Register Ais the subroutine number (0 ta 
LENSUB-1, the number of subroutines) 
LENSUB must be less than or equal ta 
126. 


Exits If the routine number is valid then 
execute the routine 
else 
Carry flag = 1 
Registers used: AF 


Time: 117 cycles plus execution time of subroutine 


Size: Program 21 bytes plus size of table (2sLENSUE) 


“weo~“es “6 “ae ~wS “SS “BS “A Ve ~Ss ~s “Ss “8 WB WS WE MB NSB We Se oe 


bl it i Se | |) eT it eT | 


s;EXIT WITH CARRY SET IF ROUTINE NUMBER IS INVALID 
THAT IS, IF IT IS TOO LARGE FOR TABLE (>LENSUE —- 1) 


JITAB: 
CP LENSUB =CQMPARE ROUTINE NUMBER, TABLE SIZE 
CCF s;COMPLEMENT CARRY FOR ERROR INDICATOR 
RET Cc sRETURN IF ROUTINE NUMBER TOO LARGE 


; WITH CARRY SET 


7; INDEX INTO TABLE OF WORD-LENGTH ADDRESSES 
;LEAVE REGISTER PAIRS UNCHANGED SQ THEY CAN BE USED 
; FOR PASSING PARAMETERS 


PUSH HL s SAVE HL 

ADD A,A ;DOQUBLE INDEX FOR WORD-LENGTH ENTRIES 
LD HL, JMPTAB 7; INDEX INTO TABLE USING S-BIT 

ADD A,L ; ADDITION TO AVOID DISTURBING 

LD LA ; ANOTHER REGISTER PAIR 

LO A,QO 

ADC A,H 

LD H,A sACCESS ROUTINE ADDRESS 


OBTAIN ROUTINE ADDRESS FROM TABLE AND TRANSFER 
; CONTROL TO IT, LEAVING ALL REGISTER PAIRS UNCHANGED 
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LD A, (HL) 
INC HL. 
LD H, CHL) 
LO L,A 
EX (SP),HL 
RET 
LENSUB EQU 3 
JIMPTAB: 
DW SUBO 
DW SUB1 
DW SUB2 
s THREE TEST SUBROUTINES 
SUBO: 
LO A, 1 
RET 
SUB1s 
LO A,2 
RET 
SUB2: 
LD A,3 
RET 


SAMPLE EXECUTION: 


a6s w8 NS SS 


wo 
Oo 
8 
= 


SUB A 
CALL JTAB 


7MQVE ROUTINE ADDRESS TO HL 


7;RESTORE OLD HL, 
sJLUMP TO ROUTINE 


PUSH ROUTINE ADDRESS 


sNUMBER OF SUBROUTINES IN TABLE 


;JUMP TABLE 
sROUTINE 0 
;ROUTINE 1 
sROUTINE 2 


FOR JUMP TABLE 


sTEST ROUTINE O SETS (A) 


i 
— 


s;TEST ROUTINE 1 SETS CA) 


il 
nh 


;TEST ROUTINE 2 SETS (A) 


i 
iw 


EXECUTE ROUTINE O 


; AFTER EXECUTION, CA) = 1 


<0 “68 


~w «ws “é 


A, 1 
JTAB 
A,2 
UTAB 
A,3 
JTAB 


SC9H 
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sEXECUTE ROUTINE 1 
; AFTER EXECUTION, (A) 
7;EXECUTE ROUTINE 2 
; AFTER EXECUTION, (A) 
EXECUTE ROUTINE 3 
; AFTER EXECUTION, CARRY 


i) i 
Ww NW 


il 
rs 


7;LOQOP FOR MORE TESTS 


Read a Line from a Terminal ([eDLINE) 


10A 


Readsa line of ASCII characters ending with 
a carriage return and saves them in a buffer. 
Defines the control characters Control H (08 
hex), which deletes the latest character, and 
Control X (18 hex), which deletes the entire line. 
Sends a bell character (07 hex) to the terminal if 
the buffer overflows. Echoes each character 
placed in the buffer. Echoes non-printable char- 
acters as an up arrow or caret (“) followed by the 
printable equivalent (see Table 10-1). Sends a 
new line sequence (typically carriage return, line 
feed) to the terminal before exiting. 

RDLINE assumes the following system-depen- 
dent subroutines: 


I. RDCHAR reads a character from the 
terminal and puts it in the accumulator. 


2. WRCHAR sends the character in the 
accumulator to the terminal. 


3. WRNEWL sends a new line sequence to 
the terminal. 


These subroutines are assumed to change all 
user registers. 

RDLINE is an example of a terminal input 
handler. The control characters and I/O subrou- 
tines in a real system will, of course, be computer- 
dependent. A specific example in the listing is 
for a computer running the CP/M operating 
system with a standard Basic Disk Operating 
System (BDOS) accessed by calling memory 
address 0005,,. Table 10-2 lists commonly used 
CP/M BDOS functions. For more information 
on CP/M, see Osborne CP/M User Guide, 
Second Edition by Thom Hogan (Berkeley: 
Osborne/ McGraw-Hill, 1982). 


Procedure: The program starts the loop by 
reading a character. If the character is a carriage 
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Registers Used: AF, BC, DE, HL 
















Execution Time: Approximately 162 cycles to place 
an ordinary character in the buffer, not including the 
execution time of RDCHAR or WRCHAR 
Program Size: 148 bytes 


Daia Memory Required: None 





Special Cases: 


1. Typing Control H (delete one character) or 
Control X (delete the entire line) when the buffer is 
empty has no effect. 


2. The program discards an ordinary character 
received when the buffer is full, and sends a bell 
character to the terminal (ringing the bell). 


return, the program sends a new line sequence to 
the terminal and exits. Otherwise, it checks for 
the special characters Control H and Control X. 
If the buffer is not empty, Control H makes the 
program decrement the buffer pointer and char- 
acter count by | and send a backspace string 
(cursor left, space, cursor left) to the terminal. 
Control X makes the program delete characters 
until it empties the buffer. 

If the character is not special, the program 
determines whether the buffer is full. If it 1s, the 
program sends a bell character to the terminal. 
If not, the program stores the character in the 
buffer, echoes it to the terminal, and increments 
the character count and buffer pointer. 

Before echoing a character or deleting one 
from the display, the program must determine 
whether the character is printable. If it 1s not 
(that is, it is a non-printable ASCII control 
character), the program must display or delete 
two characters, the control indicator (up arrow 
or caret) and the printable equivalent (see Table 
10-1). Note, however, that the character is stored 
in its non-printable form. 


Function 
Number 


(Decimal in 


Register C) 


Hex Value Printable 


Equivalent 


Control @ 
Control A 
Control B 
Control C 
Control D 
Control E 
Control F 
Control G 
Control H 
Control I 

Control J 

Control K 
Control L 
Control M 
Control N 
Control O 


Table 10-2: BDOS Functions for CP/M 2.0 


Function 
Name 


System Reset 
Console Input 
Console Output 
Reader Input 

Punch Output 

List Output 

Direct Console Input 


Direct Console Output 
Get 1/O Byte 

Set I/O Byte 

Print String 

Read Console Buffer 
Get Console Status 


10A READ A LINE FROM A TERMINAL (RDLINE) 397 


Table 10-4: ASCII Control Characters and Printable Equivalents 


Input 
Parameters 


None 

None 

E= ASCII character 
None 

E= ASCII character 
E= ASCII character 
E= FF 


E= ASCII character 
None 

E= IOBYTE 

DE = String Address 
DE = Buffer Address 


None 


Hex Value 


Printable 
Equivalent 


Control P 
Control Q 
Control R 
Control S 
Control T 
Control U 
Control V 
Control W 
Control X 
Control Y 
Control Z 
Control [ 
Control <« 
Control ] 
Control * 
Control __ 





Output 
Parameters 


None 
A= ASCII character 
None 
A= ASCII character 
None 
None 


A= ASCII character or 00 
if no character is available 
None 


A = IOBYTE 
None 

None 

(Data in buffer) 


A = 00 (no character) or A= 
FF, (character ready) 





358 INPUT/QUTPUT 
Entry Conditions 


Base address of buffer in HL 
Length (size) of buffer in bytes in A 


Examples 


1. Data: 
Result: 


Line from keyboard is ‘ENTERcr’ 

Character count = 5 (line length) 

Buffer contains ‘ENTER’ 

‘ENTER’ is sent to terminal, followed by a 
new line sequence (typically either carriage 
return, line feed or just carriage return). 

Note that the ‘cr’ (carriage return) character 
does not appear in the buffer. 


2. Data: —Linefrom keyboard is‘DMcontrolHNcontrol 
XENTETcontrolHRcer’ 

Character count = 5 (length of final line) 

Buffer contains ‘ENTER’ 

‘DMBackspaceStringN BackspaceStringBack- 
spaceStringENTETBackspaceStringR’ is 
sent to terminal, followed by a new line 
sequence. The Backspace String deletes a 
character from the screen and moves the 
cursor left one space. 


Result: 


Character 
Typed 


The sequence of operations is as follows: 


Initial 
Buffer 


Final 
Buffer 


Sent to 
Terminal 





D 
M 
Control H 
N 
Control X 


QrAmMaazm 


ontrol H 


Gea 


Empty 
‘D’ 

‘DM’ 

‘:D’ 

‘DN’ 
Empty 
‘PE 

‘EN? 
‘ENT’ 
‘ENTE’ 
‘ENTET’ 
‘ENTE’ 
‘ENTER’ 


DY 
‘DM’ 
‘Dp’ 
‘DN? 
Empty 


‘EN’ 
‘ENT’ 
‘ENTE’ 
‘“ENTET’ 
“ENTE’ 
‘ENTER’ 
“ENTER’ 


D 

M 

Backspace string 

N 

2 Backspace strings 


oe C7 lee BAN) 


Backspace string 
R 
New line string 


Exit Conditions 


Number of characters in the buffer in A 


What has happened is 


a. The operator types ‘D’, ‘M’. 

b. The operator sees that ‘M’ is wrong (it 
should be ‘N’), types Control H to delete it, and 
types ‘N’. 

c. The operator then sees that the initial “D’ is 
also wrong (it should be ‘E’). Since the error is 
not in the latest character, the operator types 
Control X to delete the entire line, and then 
types ‘ENTET”’. 

d. The operator sees that the second “T” is 
wrong (it should be ‘R’), types Control H to 
delete it, and types ‘R’. 

e. The operator types a carriage return to end 
the line. 


wa “6 ~s “8 ws 48 we 085 


ws 


—=S «wea sé e068 tS OMe hlUNEhUMN lA lee 8 wee oS,  .  ) ee) es ee oe | 


BELL 
BSKEY 
CR 
CRKEY 
CSRLFT 
DELKEY 
LF 
SPACE 
UPARRW 


BOGS 

DIRIC 
P'STRG 
STERM 


ROLINE: 


INIT: 


Title 
Name: 


Furpmses 


Entry: 


Exit: 
Register 
Times 


Sizes: 


sEQUATES 
EQU 
EGU 
EQu 
Et 
EQU 
EQU 
EGU 
EGU 
EQU 


EQU 
EQU 
ER 
EQu 


LO 


7 INITIAL 
LD 


sREAD CH 
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Read line 
ROLINE 


we <8 we <8 we “8 we <8 


Read characters from CP/M BOOS CON: device 
until carriage return encountered. All coantral 
characters but the following are placed in the 
buffer and displayed as the equivalent printable 
ASCII wharacter preceded by a caret. 

Control H: delete last character 

Control X: delete entire line 


Register pair HL = Base address of buffer 
Register A = Length of buffer in bytes 


Register A = Number af characters in buffer 


~s <8 ws ~8 ~e <8 ws <8 we ~8 «a 48 “89 ~a 


s used: AF, BC, DE, HL 
Net applicable 


Frogram L4G bytes 


~S we s8 we «8 we wa 


O7H *BELL CHARACTER CRINGS BELL CN TERMINAL) 
O8H *BACKSPACE KEYBOARD CHARACTER 

OLH | sCARRIAGE RETURN FOR CONSCILE 

ODH :CARRIAGE RETURN KEYECARD CHARACTER 

OSH >MCVE CURSOR LEFT FOR CONSOLE 

13H SDELETE LINE KEYBOARD CHARACTER 

OAH *LINE FEED FOR CONSOLE 

20H :SPACE CHARACTER 

SEH :UF ARROW GR CARET USED AS CONTROL INDICATOR 
OOO5H :BoOCSs ENTRY POINT 

é :BOOS OIRECT 170 FUNCTION 

9 2BOWS PRINT STRING FUNCTION 

“$ *CE/M STRING TERMINATOR 

C.A :C = BUFFER LENGTH 


s;HL = BUFFER POINTER 
IZE CHARACTER COUNT TO ZERO 
B,O CHARACTER COUNT = 0 


ARACTERS UNTIL A CARRIAGE RETURN IS TYPED 


360 iNpur/ouPuT 


ROLGCP : 
CALL ROCHAR ‘READ CHARACTER FROM KEYBOARD -— NO ECHO 
?CHECK FOR CARRIAGE RETURN, EXIT IF FOUND 
td CREEY 
JR Z.EXITRD ‘END GF LINE IF CARRIAGE RETURN 
SCHECK FOR BACKSPACE AND DELETE CHARACTER IF FOUND 
CP RESKEY 
JR NZ.ROLPL * BRANCH IF NOT BACKSFPACE 
CALL BACK SP IF BACKSPACE, DELETE ONE CHARACTER 
JK ROLOCF * THEN START READ LOGF AGAIN 
STHECK FOR DELETE LINE CHARACTER AND EMPTY BUFFER IF FOUND 
ROLF 1: 
IF NELKEY 
JR NZ, ROLP2 *BRANGH IF NOT DELETE LINE 
DELL: 
CALL. BACKSP sDELETE A CHARACTER 
wR NZ, DELL CONTINUE UNTIL BUFFER EMPTY 
wR ROLOCEF sTHIS ACTUALLY BACKS UF OVER EACH 
* CHARACTER RATHER THAN JUST MOVING 
: UP A LINE 
*NOT A SPECIAL CHARACTER 
: CHECK IF BUFFER IS FULL 
; IF FULL, RING BELL AND CONTINUE 
> IF NOT FULL, STORE CHARACTER AND ECHO 
ROLP2: 
LO E,A SAVE CHARACTER 
Lo A,B :15 BUFFER FLILL? 
CP C s COMPARE CQUNT AND BUFFER LENGTH 
IR C, STROH s JUMP IF BUFFER NOT FULL 
LO A, BELL. sFULL, RING THE TERMINAL’S BELL 
CALL WRCHAR 
JK ROLOGF THEN CONTINUE THE READ LOOP 
;BUFFER NOT FULL. STORE CHARACTER 
STRCH: 
Lo A.E sGET CHARACTER BACK 
i 8 CHLD,A sSTORE CHARACTER IN BUFFER 
ING HL s INCREMENT BUFFER PCINTER 
INC gE s INCREMENT CHARACTER COUNT 
IF CHARACTER IS CONTROL, THEN OUTPUT 
> UP ARROW FOLLOWED BY PRINTABLE EQUIVALENT 
Cr SPACE sCONTROL IF LESS THAN SPACE (20 HEX) 
JR Nt, PRCOH s JUMP IF A PRINTABLE CHARACTER 
PUSH AF SAVE CHARACTER 
Lo A, UPARRW >WRITE UP ARROW OR CARET 
CALL WROHAR 
POF AF sRECOVER CHARACTER 
ADT A, 40H sCHANGE TO FRINTABLE FORM 
FRCH: TALL WRCOHAR Y,ECHO CHARACTER TO TERMINAL 


AK ROLOOPF 7THEN CONTINUE READ LOOP 


EXITROs: 


ROCHAR: 


ROWAIT: 


WRCHAR s 
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sEXIT 
7;SEND NEW LINE SEQUENCE CUSUALLY CR,LF) TQ TERMINAL 
365ET LENGTH OF LINE 


CALL WRNEWL 7SEND NEW LINE SEQUENCE 

Lo A,E sLINE LENGTH = CHARACTER COUNT 
RET 

RE SRE SOE soe Sat pb Sot et sat sot oot set ma et oot spe et oo; sot oot set So: sett so; Soh pt te oS ot ee Ew a ee et EE ot 


sROUTINE: ROCHAR 

PURPOSE: READ CHARACTER BUT DC NOT ECHO TO CONSOLE 
sENTRY: NONE 

sEXITs REGISTER A = CHARACTER 

;REGISTERS USED: ALL EXCEPT BC, HL 


PUSH HL 7 SAVE Bt, HL 
FSH BC 


sWAIT FOR CHARACTER FROM CONSOLE 


Lo C,DIRIG SDIRECT CONSOLE I/O 

Lo E, OFFH INDICATE INPUT 

CALL BDOS ;READ CHARACTER FROM CONSOLE 

OR A ;LOOP IF NO CHARACTER (A = 0) 

JK Z,RDWAIT 

POF DE ;RESTORE BC, HL 

POF HL 

RET sRETURN WITH CHARACTER IN REGISTER A 
S HRAKRHRKRGHRSR ERK RESO ESE REE ee 


sROUTINE: WRCHAR 

;PURPOSE: WRITE CHARACTER To CONSOLE 
sENTRY: REGISTER A = CHARACTER 
s;EXIT: NONE 

FREGISTERS USED: ALL EXCEPT BC, HL 


} HERS AARKKSSKRERKKRE ERE R EERE CR Ree 
PUSH HL ;SAVE BC, HL 


PUSH BC 


sWRITE A CHARACTER 


Lo C,DIRIO DIRECT CONSOLE T/t 

Lo ELA SINDICATE OQUTFUT ~ CHARACTER IN E 
CALL BDO: 7WRITE CHARACTER ON CONSOLE 

FOF BC sRESTORE BC, HL 

POP HL. 

RET 

SDE IDE BE Sat Sat oe ot Sot Jot sot sot cot opt et tn st oot So: oe Sot op tee ee ot EEE Bw De 


;ROUTINE: WRNEWL 
;PURFOSE: ISSUE NEW LINE SEQUENCE TO CONSOLE 


362 NeuT/ouTPUT 


WRNEWL : 


NLSTRG: 


e' 
eee! 


NORMALLY, THIS IS A CARRIAGE RETURN AND 
LINE FEED, BUT SOME COMPUTERS REQUIRE ONLY 
A CARRIAGE RETURN. 

ENTRY: NONE 

sEXIT: NONE 

sREGISTERS USED: ALL EXCEPT BC, HL 

} FFUASKGKKASSLS AGRA TREKS RRR RRS, 


wa <3 we 


PUSH HL SAVE BC, HL 
PLUSH ed 


SEND) NEW LINE STRING Ta CONSOLE 
Lo DE, NLSTRG ;FPOINT TO NEW LINE STRING 
CALL WRETRG 7SEND STRING TO CONSOLE 


POP BC ;RESTORE BC, HL 
FOF Hi 
RET 


i) CRY LF, STERM 7;NEW LINE STRING 
; NOTE: STERM ($) [8 CR/M TERMINATOR 


aa; S95 DE goy SAE ee Sm ses ee et Bes set set opt Seb poet Set et BE a ee eh EB Ew i ww EE we 
SROUTINE: BACK SF 
?PURFOSE: PERFORM A DESTRUCTIVE BACKSPACE 
ENTRY: B = NUMBER OF CHARACTERS IN BUFFER 
HL = NEXT AVAILABLE BUFFER ADDRESS 
XIT: IF NO CHARACTERS IN BUFFER 
Z= 1 
ELISE 
Z= 0 
THARACTER REMOVED FROM BUFFER 
SREGISTERS USED: ALL EXCEPT C, HL 


iG 


es es <8 ws 48S we «8 w 


?CHECE FOR EMF TY BUFFER 

Lo A,B ; TEST NUMBER OF CHARACTERS 
CIR A 

RET Z sEXIT IF BUFFER EMPTY 


POUTPUT BACKSPACE STRING 

; TO REMOVE CHARACTER FROM LUISPLAY 

NEC HL ;DECREMENT BUFFER POINTER 

PUSH HL. SAVE BC, HL 

PUSH EC 

Lo A, CHL) GET CHARACTER 

cr 20H 2:15 IT A CONTROL? 

JR NC, BS4 NO, BRANCH, DELETE ONLY ONE CHARACTER 
Lo DE, ESSTRG YES, DELETE 2 CHARACTERS 

(UP ARROW AND PRINTABLE EQUIVALENT) 
CALL WRISTRG ;WRITE BACKSPACE STRING 

Lo DE, BSSTRG 

CALL WRSTRG WRITE BACKSPACE STRING 

FCF EC SRESTORE BC, HL. 

POP HL 


ws Se WS 


WRSTRG: 


@S8 we ~S8 “We O85 


PROMPT 


ory 
Oo 
ry 
Oo 
> 
ees 


TLOOP: 
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;DECREMENT CHARACTER COUNT BY 1 
DEC E ;ONE LESS CHARACTER IN BUFFER 
RET 


DESTRUCTIVE BACESPACE STRING FOR CONSOLE 

;MOVES CURSOR LEFT, PRINTS SPACE OVER CHARACTER. MOVES 
; CURSOR LEFT 

;NOTE: STERM (%) IS CF/M STRING TERMINATOR 

De CSRLFT, SPACE, CSRLFT, STERM 

SPEDE i ee ee Be ae Be a a Se ee RE a RE RE wR RE EE 

;ROUTINE:s WRSTRG 

*PURPOSE: OUTPUT STRING TO CONSOLE 

s;ENTRY: HL = BASE ADDRESS OF STRING 

sEXIT: NONE 


s;REGISTERS USED: ALL EXCEPT BC 
BEBE: Be a Bi i be pe wa RE wR a Ko RK RSS Re SE 


PUSH BC sSAVE BC 

Lo C,PSTRG FUNCTION IS PRINT STRING 

CALL Bods sQUTPUT STRING TERMINATED WITH $ 
POF BC SRESTORE BC 

RET 


SAMPLE EXECUTION: 


“us ‘we «se =a «8 


s;EQUATES 
EGU eee OPERATOR FROMPT = QUESTICN MARE 


;READ LINE FROM CONSOLE 


LD A, PROMPT ;QOUTPUT PROMPT ¢ 7) 
CALL WRCHAR 
LO HL, INBUFF sHL = INFUT BUFFER ADDRESS 
LD A, LINBUF 7A = BUFFER LENGTH 
CALL RDL INE ;READ A LINE 
OR A TEST LINE LENGTH 
JK Z,SC10A s;NEXT LINE IF LENGTH IS 0 
3;ECHO LINE TO CONSOLE 
LO B,A 7;SAVE NUMBER OF CHARACTERS IN BUFFER 
LD HL, INBUFF ;PGOINT TGQ START OF BUFFER 
LD A, CHL) ;QUTPUT NEXT CHARACTER 
CALL WRCHAR 
INC HL s; INCREMENT BUFFER POINTER 
DINZ TLOOP ;DECREMENT CHARACTER COUNT 
: CONTINUE UNTIL ALL CHARACTERS SENT 
CALL WRNEWL THEN END WITH CR,LF 


JR SC LOA 
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sDATA SECTION 
LINBUF Ett 16 LENGTH OF INPUT BUFFER 
INBUFF: DS LINBUF 2 INPUT BUFFER 


END 


Write a Line to an Output Device (\\ieL!NE) 


Writes characters until it empties a buffer 
with given length and base address. Assumes the 
system-dependent subroutine WRCHAR, which 
sends the character in the accumulator to the 
output device. 

WRLINE is an example of an output driver. 
The actual I/O subroutines will, of course, be 
computer-dependent. A specific example in the 
listing is for a CP/M-based computer with a 
standard Basic Disk Operating System (BDOS) 
accessed by calling address 0005 ,,. 

Procedure: The program exits immediately if 
the buffer is empty. Otherwise, it sends characters 


Entry Conditions 


Base address of buffer in HL 


Number of characters in the buffer in A 


Example 


Number of characters = 5 
Buffer contains ‘ENTER’ 
‘ENTER’ sent to the output device 


1. Data: 


Result: 


Write line 
WRL INE 


Title 
Name: 


wa “8S ve “8 we “8 we <8 


10B 


Registers Used: AF, BC, DE, HL 


Execution Time: 18 cycles overhead plus 43 cycles 


per byte besides the execution time of subroutine 
WRCHAR 


Program Size: 22 bytes 
Data Memory Required: None 


Special Case: An empty buffer causes an immediate 
exit with nothing sent to the output device. 





to the output device one at a time until it empties 
the buffer. The program saves all temporary 
data in memory rather than in registers to 
avoid dependence on WRCHAR. 


Exit Conditions 


None 


<8 we «8 ws 285 we 38 
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“ue “8 we 43 ‘wa 


“awe “NS ws “8 


—s we “& ews “8 


BOOS 
DIRIO 


WRL INE: 


WRLLF: 


WRCHAR: 


Purpmses Write characters toa CP/M BOOS CON: device 


Entrys Register pair HL = Base address of buffer 
Register A = Number of characters in buffer 


Exits None 


Registers used: All 


Times Net applicable 
Sizes Fragram 22) bytes 


; EQUATES 
EQu OO0O3H s;BOOS ENTRY POINT 
Etat & 7800S DIRECT 1/0 FUNCTION 


sEXIT IMMEDIATELY IF BUFFER IS EMPTY 


OR A : TEST NUMBER OF CHARACTERS 
RET Z >; RETURN IF BUFFER EMPTY 
Lo B,A 7B = COUNTER 


sHL = BASE ADDRESS OF BUFFER 


s;LOOP SENDING CHARACTERS TO OUTPUT DEVICE 


LE A, CHL) 7GET NEXT CHARACTER 

CALL WRCHAR 7SEND CHARACTER TO QUTFUT DEVICE 
INC Hi. 7; INCREMENT BUFFER POINTER 

DWINZ WRLLP ;DECREMENT COLINTER 


; CONTINUE UNTIL ALL CHARACTERS SENT 
RET 


BE 0: Be BE SE owe pe ot Be ewe ee we be nt tb et eh ee Ee ee ER EE 
;ROQUTINE: WROHAR 

;PURPOSEs WRITE CHARACTER TO QUTPUT DEVICE 
;ENTRY: REGISTER A = CHARACTER 

,;EXIT: NONE 

7REGISTERS USED: AF, DE 

OEE Be i Se He BE es EE we ER RE Rw She RR eR 


PUSH HL ;SAVE BC, HL 

PLUSH BC 

LO C, DIRIGO sOTRECT I/O FUNCTION 

Lo E,A s;CHARACTER IN REGISTER E 
CALL BOOS ;QUTPUT CHARACTER 

POF BC s;RESTORE BC, HL 

POP HL 


RET 


ws =<=8 ~s ss -ee ~S we “S “eB Sh we 4S UB 


=a 


we “BS 4B ws “8 


RCBUF 


CR 
PROMPT 


Peet] 


SCiLObBs 


CRLF: 
LINBUF 
INBUFF : 


SAMPLE EXECUTION: 


Eu 10 
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“<s we =a 


<s “se 


;BO0S READ CONSOLE BUFFER FUNCTICN 


;BOOS READ CONSOLE BUFFER FUNCTION USES 
; THE FOLLOWING BUFFER FORMAT: 


7 BYTE 0 : BUFFER LENGTH (MAXIMUM NUMBER OF CHARACTERS) 
; BYTE 1 >: NUMBER OF CHARACTERS READ (CLINE LENGTH) 
; BYTE 2 ON: ACTUAL CHARACTERS 


7;CHARACTER EQUATES 


EQU ODH 
EGU OAH 
ELI a“ ? ” 


s;REALD LINE FROM CONSOLE 


Lo A, PROMPT 
CALL WRCHAR 

Lo DE, INBUFF 
Lo C, RCBUF 
CALL BOOS 

LO A,LF 


CALL WRCHAR 


s;WRITE LINE TO CONSOLE 


LD HL, INBUFF+1 
Lo A,M 

INC HL. 

CALL WRL INE 

LD HL, CRLF 

LD A,2 


CALL WRL INE 
IR SCLOB 


7DATA SECTION 


DEB CR, LF 
EQU 10H 

DB LINBUF 
DS LINBUF 


END 


s;CARRIAGE RETURN FOR CONSOLE 
;LINE FEED FOR CONSOLE 
;QOPERATOR PROMPT = QUESTION MARE 


7O0UTPUT PROMPT ('?) 


s;FOINT TO INPUT BUFFER 
;EDOS READ LINE FUNCTION 
;READ LINE FROM CONSOLE 
;QUTPUT LINE FEED 


?;POINT AT LENGTH BYTE RETURNED BY CP/M 
7;GET LENGTH OF LINE 

;FOINT TO FIRST DATA BYTE OF INBUFF 
;WRITE LINE 

;QUTPUT CARRIAGE RETURN, LINE FEED 
LENGTH OF CRLF STRING 

7;WRITE CRLF STRING 


s CONTINUE 


7;CARRIAGE RETURN, LINE FEED 
s;LENGTH OF INPUT BUFFER 
s;LENGTH GF INPUT BUFFER 
;DATA BUFFER 


CRC-16 Checking and Generation 


(ICRO16,CRC16,6CRC16) 


Generates a 16-bit cyclic redundancy check 
(CRC) based on the IBM Binary Synchronous 
Communications protocol (BSC or Bisync). 


Uses the polynomial X!6 + X!5+ XK2+ 1. Entry. 


point ICRC16 initializes the CRC to 0 and the 
polynomial to the appropriate bit pattern. Entry 
point CRC16 combines the previous CRC with 
the CRC generated from the current data byte. 
Entry point GCRC16 returns the CRC. 
Procedure: Subroutine ICRC 16 initializes the 
CRC to 0 and the polynomial to a | in each bit 
position corresponding to a power of X present 
in the formula. Subroutine CRC16 updates the 
CRC for a data byte. It shifts both the data and 
the CRC left eight times; after each shift, it 
EXCLUSIVE-ORs the CRC with the polynomial 
if the EXCLUSIVE-OR of the data bit and the 
CRC’s most significant bit is 1. Subroutine 
CRC16 leaves the CRC in memory locations 
CRC (less significant byte) and CRC+1 (more 


Entry Conditions 
1. ICRCI16: none 


2. CRC16: data byte in A, previous CRC in 
memory locations CRC (less significant byte) 
and CRC+ | (more significant byte), CRC polynomial 
in memory locations PLY (less significant byte) 
and PLY+1 (more significant byte) 


3. GCRC16: CRC in memory locations CRC 


(less significant byte) and CRC+1 (more significant 
byte) 
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Registers Used: 

1. ICRC16: HL 

2. CRC16: None 

3. GCRCI16: HL 
Execution Time: 

1. ICRC16: 62 cycles 


2. CRC16: 148 cycles overhead plus an average of 
584 cycles per data byte, assuming that the previous 
CRC and the polynomial must be EXCLUSIVE-ORed 
in half of the iterations 


3. GCRCI6: 26 cycles 
Program Size: 

1. ICRCI16: 13 bytes 
2. CRCI6: 39 bytes 
3. GCRCI6: 4 bytes 


Data Memory Required: 4 bytes anywhere in 
RAM for the CRC (2 bytes starting at address CRC) 
and the polynomial (2 bytes starting at address PLY) 





significant byte). Subroutine GCRC16 loads the 
CRC into HL. 


Exit Conditions 


1. ICRC16: 0 (initial CRC value) in memory 
locations CRC (less significant byte) and 
CRC+1 (more significant byte), CRC 
polynomial in memory locations PLY (less 
significant byte) and PLY+1 (more significant 
byte) 


2. CRC16: CRC with current data byte in- 
cluded in memory locations CRC (less significant 


byte) and CRC+1 (more significant byte) 


3. GCRC16: CRC in HL 
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Examples 
1. Generating a CRC 2. Checking a CRC 
a. Call ICRC16 for initialization and to start the CRC a. Call ICRC16 for initialization and to start the CRC 
at 0. at 0. 
b. Call CRCI6 repeatedly to update the CRC for each b. Call CRC16 repeatedly to update the CRC for each data 
data byte. byte (including the stored CRC) for checking. 
c. Call GCRCI16 to obtain the final CRC. c. Call GCRCI16 to obtain the final CRC; it will be 0 if 


there were no errors. 


Note that only ICRC16 depends onthe particular memory locations PLY (less significant byte) 
CRC polynomial used. To change the polynomial, and PLY+1 (more significant byte). 
simply change the data ICRC16 loads into 


REFERENCE 


J.E.McNamara. Technical Aspects of Data Communications, 2nd ed. Billerica, Mass.: 
Digital Press, 1982. This book contains explanations of CRC and communications 
protocols. 


we ~8 ~es “8S wa @S we «8 
we @8 “ee “8 we w8 “SB NS 


Title Generate CRC-16 
Names: CREOLE 
Purposes Generate a 16-bit CRC based an IBM’s Binary 


Synchranaus Cammunications pratocal. The CRO is 
based oan the polynomial: 
(* indicates "to the pawer") 
X*16 + X*1S + X*%2 + 1 


To generate a CRC: 
1) Call ICRC16 toa initialize the CRC 
Polynomial and clear the CRC. 
2) Call CRCO146 for each data byte. 
3) Call GCORCI6 to obtain the CRC. 
It should then be appended ta the data, 
high byte first. 


“we “68 wa “8 ws “8 we “WS ws WE 


Tt ee ee, |) |) er ) er ee 


=e 6“8 ws wS8 
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CRCOL6: 


CRCOLP: 


To check a CRC: 
1) Call ICRC16 toa initialize the CRC. 
2) Call CRCO1I6 for each data byte and 


the 2 bytes af CRC previously generated. 
3) Call GCRC16 to obtain the CRC. It will 


be zgera if no errors accurred. 


Entrys ICRC1IG —- None 
CRO1I6 - Register A = Data byte 
GCRC146 —- None 


Exits ICRC1I6 - CRC, PLY initialized 
CRO16& - CRO updated 
GORCIGE - HL = CRC 

Registers used: None 

Time: 143 eyeles overhead plus an average of 3584 
cycles per byte, assuming that half the 
iterations require EXCLUSIVE-ORing the CRC 
and the polynomial. 


Sizes Program 346 bytes 
Data 4 bytes 


3SAVE REGISTERS 


PUSH AF 

PLUSH BC 

PUSH DE 

PUSH HL. 

SLOOP THROWGH EACH BIT GENERATING THE CRC 

Lo b,S 7& BITS PER BYTE 

Lo DE, (PLY) ;GET POLYNOMIAL 

Loi HL, (CRC) *GET CURRENT CRC VALUE 

Lo CLA sSAVE DATA C 

AND LOOOO000E sGET BIT 7 OF DATA 

XOR H SEXCLUSIVE-OR EIT 7 WITH BIT iS OF CRC 
Lo H,A 

ADL HL, HL sSHIFT CRC LEFT 

IR NC, CROLP 1 sQuUMF IF BIT 7 QF EXCLUSTVE-OR WAS O 


;BIT 7 WAS 1, SOQ EXCLUSIVE-OR CRC WITH POLYNOMIAL 


Lo A,E 2GET LOW BYTE OF POLYNOMIAL 

XOR L sEXCLUSIVE-QR WITH LOW BYTE OF CRC 
Lo LA 

Lo A, sGET HIGH BYTE OF POLYNOMIAL 

XOR H sEXCLUSIVE-OR WITH HIGH BYTE OF CRC 
Lo H,A 


48 we “WS we “8 we ~S we <8 we VS we VS we “SES we WE 


~e ~8 we “8 we “WS ws “8 we “8 we 
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CRCLPL: 
LO A,C 7;RESTORE DATA 
RLA ;SHIFT NEXT DATA BIT TO BIT 7 
DINZ CRCLP ;DECREMENT BIT COUNTER | 
; JUMP IF NOT THROUGH 3s BITS 
LO (CRC),HL 7;SAVE UPDATED CRC 
;RESTORE REGISTERS AND EXIT 
POP HL 
POP DE 
POF BC: 
POP AF 
RET 


FROUTINE: ICRC1é 

PURPOSE: INITIALIZE CRC AND PLY 
;ENTRY: NONE 

s;EXIT: CRC AND POLYNOMIAL INITIALIZED 
;REGISTERS USEDs HL 


DES aE; De Bb ee Be he ae ee bE we ee we ee we ee ee a aE EE EE EE EE 
ICRC16: 
Lo HL, © ;CRC = 0 
Lo CORO), AL 
i HL, OS005H ;PLY = SO03H 
LO (PLY), HL SOOSH IS FOR X*16+X*15+xX*2+1 


7A 1 IS IN EACH BIT POSITION 

; FOR WHICH A POWER APPEARS IN 

; THE FORMULA (BITS 0, 2, AND 15) 
RET 


sROUTINE: GCRCOLE 

;PURPOSE: GET CRC VALUE 

s;ENTRY: NONE 

FEXIT: REGISTER PAIR HL = CRC VALUE 
;REGISTERS USED: HL 


LO HL, (CRC) y;HL = CRC 
RET 
7 DIATA 
CRC: 2 ;CRC VALUE 
PLY: a 2 ;POLYNOMIAL VALUE 
H SAMPLE EXECUTION: 7 


7;GENERATE A CRO FOR THE NUMBER 1 AND CHECK IT 


ty 
ci 
uot 
2 
m 
se 
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GENLF's 


CHELP: 


sINITIALIZE CRC, FOLYNOMTAL 
;GENERATE CRC FOR 1 


7;SAVE CRC IN DE 
s INITIALIZE AGAIN 
7CHECK CRC BY GENERATING IT FOR DATA 


>; AND STORED CRC ALSO 


sCRC SHOULD BE ZERG IN HL 


;GENERATE CRC FOR THE SEQUENCE 0,1,2,...,255 AND CHECK IT 


CALL ICRC1I4G 
Lo A, 1 
CALL CRO 
CALL GRIT LE 
EX DE, HL 
TALL ICRC14 
Lo A, 1 
CALL CROLG 
Lo A, 
CALL CREOLE 
LD A,E 
CALL CROL6 
CALL GCROLSG 
CALL ICRC14 
LD B,O 

Lo A,B 
CALL TROLS 
INC B 

JR NZ, GENLP 
CALL GCROL6 
EX DE, HL 
sCHECK CRC BY GENERATING 
CALL ICRC1é 
LO G,0O 

Lo A,B 
CALL CREOLE 
INC td 

JR NZ, CHELP 
sALSO INCLUDE 
Lo A,0 
CALL. CREOLE 
LO A,E. 
CALL CREOLE 
CALL GCRC16 
IR SC 10c 


END 


7INITIALIZE CRC, POLYNOMIAL 
;3TART DATA BYTES AT O 


7;GET DATA BYTE 

;UPDATE CRC 

7ADD 1 TO PRODUCE NEXT DATA BYTE 
;BRANCH IF NOT DONE 


7;GET RESULTING CRC 
;AND SAVE IT IN DE 


IT AGAIN 
;INITIALIZE CRC, POLYNOMIAL 
7START DATA BYTES AT © 


;GET DATA BYTE 
SUPDATE CRC 
FADD 1 TO PRODUCE NEXT DATA BYTE 


STORED CRC IN CHECK 


;UPDATE FOR HIGH BYTE OF STORED CRC 


;UPDATE FOR LOW BYTE GF STORED CRC 


3;GET RESULTING CRC 
IT SHOULD BE 0 


1/O Device Table Handler (}OHD.) 


Performs input and output in a device- 
independent manner using I/O control blocks 
and an I/O device table. The I/O device table is 
a linked list; each entry contains a link to the 
next entry, the device number, and starting 
addresses for routines that initialize the device, 
determine its input status, read data from it, 
determine its output status, and write data to it. 
An I/O control block is an array containing the 
device number, operation number, device status, 
and the base address and length of the device’s 
buffer. The user must provide IOHDLR with the 
base address of an I/O control block and the 
data if only one byte is to be written. IOHDLR 
returns the status byte and the data (if only one 
byte is read). 

This subroutine is an example of handling 
input and output in a device-independent man- 
ner. The I/O device table must be constructed 
using subroutines INITDL, which initializes the 
device list to empty, and ADDDL, which adds a 
device to the list. 

An applications program will perform input 
or output by obtaining or constructing an I/O 
control block and then calling IOHDLR. IOHDLR 
uses the I/O device table to determine how to 
transfer control to the I/O driver. 

Procedure: The program first initializes the 
status byte to 0, indicating no errors. It then 
searches the device table, trying to match the 
device number in the I/O control block. If it 
does not find a match, it exits with an error 
number in the status byte. If it finds a match, it 


Entry Conditions 


1. IOQHDLR: Base address of input/ output 
control block in IX 
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Registers Used: 
1. IOHDLR: AF,BC,DE,HL,IX 
2. INITDL: HL 
3. ADDDL: DE 

Execution Time: 


1. IOHDLR: 270 cycles overhead plus 90 cycles 
for each unsuccessful match of a device number 


2. INITDL: 36 cycles 
3. ADDDL: 72 cycles 


Program Size: 


1. IOHDLR: 70 bytes 
2. INITDL: 7 bytes 
3. ADDDL: 12 bytes 


Data Memory Required: 3 bytes anywhere in 
RAM for the device list header (2 bytes starting at 
address DVLST) and temporary storage for data to 
be written without a buffer (1 byte at address 
BDATA) 


checks for a valid operation and transfers control 
to the appropriate routine from the device table 
entry. That routine must end by transferring 
control back to the original caller. If the operation 
is invalid (the operation number is too large or 
the starting address for the routine is 0), the 
program returns with an error number in the 
Status byte. 

Subroutine INITDL initializes the device list, 
setting the initial link to 0. 

Subroutine ADDDL adds an entry to the 
device list, making its base address the head of 
the list and setting its link field to the old head of 
the list. 


Exit Conditions 


1. IOQHDLR: I/Ocontrol block status byte 


in A if an error is found; 
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Data byte (if the operation is 
to write one byte) in A 


2. INITDL: None 


3. ADDDL: Base address of a device table 
entry in HL 


otherwise, the routine exits 

to the appropriate I/O driver. 
Data byte in A if the opera- 

tion is to read one byte 


2. INITDL: Device list header (addresses 


DVLST and DVLST+1) 
cleared to indicate empty list 


3. ADDDL: Device table entry added to 


list 





Example 


1. The example in the listing uses the following structure: 


Input/Output Operations 


Operation 
Number Operation 

0 Initialize device 

] Determine input status 

2 Read | byte from input device 

3 Read N bytes (normally | line) from input 
device 

4 Determine output status 

5 Write | byte to output device 

6 Write N bytes (normally | line) to output 
device 


Input/Output Control Block 


Index Contents 


0 Device number 

1 Operation number 

2 Status 

3 Less significant byte of base address of 
buffer 

4 More significant byte of base address of 
buffer 

5 Less significant byte of buffer length 

6 More significant byte of buffer length 


Device Table Entry 


Index Contents 


0 Less significant byte of link field (base address 
of next entry) 


10 


11 


More significant byte of link field (base address 
of next entry) 

Device number 

Less significant byte of starting address of 
device initialization routine 

More significant byte of starting address of 
device initialization routine 

Less significant byte of starting address of 
input status determination routine 

More significant byte of starting address of 
input status determination routine 

Less significant byte of starting address of 
input driver (read | byte only) 

More significant byte of starting address of 
input driver (read | byte only) 

Less significant byte of starting address of 
input driver (N bytes or | line) 

More significant byte of starting address of 
input driver (N bytes or | line) 

Less significant byte of starting address of 
output status determination routine 

More significant byte of starting address of 
output status determination routine 

Less significant byte of starting address of 
output driver (write | byte only) 

More significant byte of starting address of 
output driver (write 1 byte only) 

Less significant byte of starting address of 
output driver (N bytes or | line) 

More significant byte of starting address of 
output driver (N bytes or 1 line) 


If an operation is irrelevant or undefined (such as output 
status determination for a keyboard or input driver for a 
printer), the corresponding starting address in the device 


table is 0. 


=a <~s ~s “8 we “8 we “8 
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Status Values 


Description 


No errors 
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Bad device number (no such device) 
Bad operation number (no such operation 


or invalid operation) 


Input data available or output device ready 

Buffer too small for use by CP/M BDOS 
function 10 (Read Console Buffer). This 
function requires 2 bytes for the buffer 
length and character count. 


Title 
Name: 


Purpases 


I/Q Device Table Handler 
IQHDLR 


Perform I/O in a device-independent manner. 
This can be done only by accessing all 
devices in the same way using an I/0 Control 
Block (CIOCB) and a device table. The routines 
here allow the following operations: 


Operation number Descriptican 
Initialize device 
Determine input status 
Read 1 byte 

Read N bytes 

Determine output status 
Write 1 byte 

Write N bytes 


Ub WhIe S&S 


Other aperations that could be included are 
Qpen, Close, Delete, Rename, and Append, which 
would support devices such as floppy disks. 


A IQCB is an array of the following farm: 


IOCB + 0O = Device number 

IOCB + 1 = OQperaticn number 

IOCB + 2 = Status 

IQCB + 3 = Law byte of buffer address 
IacB + 4 = High byte of buffer address 
TacB + 5 = Low byte of buffer length 
IOCB + 46 = High byte of buffer length 


<s “ws “8 “ese +" 


, 8 88 we 
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Entrys 


Exits 


Registers used: 


Times 


The device table is implemented as a linked 
Two routines maintain the list: INITDL, 


list. 


which initializes the device list to empty, and 
which adds a device ta the list. 


ADDOL , 


A device table entry has the following form: 


DVTBL 
DVTBL 
DVTBL 
DVT BL 
OVTBL 
DVTBL 
DVTBL 
DVTBL 
DVTBL 
DVTBL 
DVTBL 
DVTBL 
DVTBL 
DVTBL 
DVTBL 
DVTBL 
DVTBL 


t+eee tee eeetee eee 
ee he re ee ee QON ST OP Whe © 


,Cl Phe 


Hudinbaiuw tu 


| ee | | | 


Register IX 


Register A 


Register A 


Low byte of link field 

High byte of link field 

Device number 

Low byte af device initialization 
High byte af device initialization 
Low byte of input status routine 
High byte of input status routine 
Low byte of input 1 byte routine 
High byte of input 1 byte roautine 
Low byte of input N bytes routine 
High byte of input N bytes routine 
Low byte of output status routine 
High byte of cutput status routine 
Low byte of cutput 1 byte routine 
High byte of output 1 byte routine 
Low byte of cutput N bytes routine 


High byte of output N bytes routine 


Base address of IGCB 
Far write il byte, contains the 
data (no buffer is used) 


= Copy of the IOQCB status byte 


Except contains the data for 
read i byte (na buffer is used) 


Status byte af IOCB is OQ if the operation was 


completed successfully; atherwise, it cantains 


the error number. 


Status value 


.@) No errors 

i Bad device number 

2 Bad operation number 

3 Input data available or output 
device ready 

2354 Buffer toa small for CP/M BDOS 
function 10 (Read Console 
Buf fer) 

AF,BC,DE,HL,IXx 


Description 


270 cycles minimum plus 90 cycles for each 
device in the list which is nat the requested 


device 


Pragram 89 bytes 


Data 


3 bytes 


“us «we “8S ~e we ues 4S NA MS SB eS WS NS MH WS 8 NH NS ue Me NB Ns we NS MEH VR NE UE NH SE MB Gg es ws us ue us Me “ws 6“e8 6~O 
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TOCBDN 
IOCBOP 
IOCBST 
IOCBBA 
TOCBBL 
DTLNK 
DTON 
DTSR 


NUMOP 
INIT 

ISTAT 
RIBYTE 
RNBY TE 
COSTAT 

WIBYTE 
WNEYTE 


NOERR 
DEVERR 
OPERR 
DEVRDY 
BUFERR 


IGHDLR: 


SRCHLP: 
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;IOCB AND DEVICE TABLE EQUATES 


EQuU 0 ;IOCB DEVICE NUMBER 

EQu 1 :IOCB OPERATION NUMBER 

EQU 2 7I0CB STATUS 

EQU 3 ;10CB BUFFER ADDRESS 

EQu va ;I0CE BUFFER LENGTH 

EQU 0 ;DEVICE TABLE LINK FIELD 

EQU 2 ;DEVICE TABLE DEVICE NUMBER 

Eau 3 ;BEGINNING OF DEVICE TABLE SUBROUTINES 


sCPERATION NUMBERS 


EQU 7 sNUMBER OF OPERATIONS 

EQu e) s INITIALIZATION 

EAU 1 s INPUT STATUS 

EQu 2 sREAD 1 BYTE 

EQU 3 ;READ N BYTES 

EQu 4 sOUTPUT STATUS 

EMU = ;WRITE 1 BYTE 

EQU é ;WRITE N BYTES 

,STATUS VALUES 

EQU 0 ;NO ERRORS 

EQu 1 ?;BAD DEVICE NUMBER 

EQU 2 ;GAD OPERATION NUMBER 

EQu 3 INPUT DATA AVAILABLE QR QUTFUT DEVICE READY 
EU 254 ;BUFFER TOO SMALL FOR BOOS READ CONSOLE BUFFER 
LD (BDATA),A ;SAVE DATA BYTE FOR WRITE 1 BYTE 


sINITIALIZE STATUS BYTE TO ZERO (NO ERRORS) 
Lo CIX+ITOCBEST) , NGERR ;STATUS = NO ERRORS 


7;CHECK THAT OPERATION IS VALID 


Lo A, CIX+IOCBOP ) 7;GET OPERATION NUMGER FROM ITOCE 

Lo B,A 7SAVE UPERATION NUMBER 

CP NUMOP IS GPERATION NUMBER WITHIN LIMIT? 
AR NC, BADOP ;JUMP IF OPERATION NUMBER TOO LARGE 
7;SEARCH DEVICE LIST FOR THIS DEVICE 

7C = [OCB DEVICE NUMBER 

7DE = POINTER TO DEVICE LIST 


LD C, (IX+ITOCBON) 7;C = [OCB DEVICE NUMBER 

Lo DE, (DVLST) 7DE = FIRST ENTRY IN DEVICE LIST 
7;DE = POINTER TO DEVICE LIST 

7& = GPERATION NUMBER 

3;C = REQUESTED DEVICE NUMBER 

7;CHECK IF AT END OF DEVICE LIST (LINK FIELD = 0000) 

LD A,D TEST LINK FIELD 

QR E 

ul Z, BADUN s;BRANCH IF NO MORE DEVICE ENTRIES 
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FOUND: 


BADDON: 


BADOF: 


EREXIT: 


SCHECK IF CURRENT ENTRY 


LD 
ADD 
Lo 
CP 
IR 


DEVICE NOT FOUND, 


HL, DTDN 
HL, DE 
A, CHL) 
C 
Z,F OUND 


IS DEVICE IN I0CB 
;POINT TO DEVICE NUMBER IN ENTRY 


;COMPARE TO REQUESTED DEVICE 
;BRANCH IF DEVICE FOUND 


ADVANCE TO NEXT DEVICE 


; TABLE ENTRY THROUGH LINK FIELD 


; MAKE CURRENT DEVICE = 


EX 
Lo 
INC 
Lo 
AR 


;FOUND DEVICE, 


; DE 


De, HL 
E, (HL) 
HL 

D, (HL) 
SRCHLP 


LINK 


s;PQINT TO LINK FIELD (FIRST WORD) 
;GET LOW BYTE OF LINK 


7;GET HIGH BYTE OF LINK 
sCHECK NEXT ENTRY IN DEVICE TABLE 


SO VECTOR TQ APPROPRIATE ROUTINE IF ANY 
ADDRESS OF DEVICE TABLE ENTRY 
7B = QPERATION NUMBER 


7;GET ROUTINE ADDRESS (ZERO INDICATES INVALID) OPERATION) 


LD 
LD 
ADL 
Lo 
ADD 


ADD 
Lo 
INC 
Lo 
Lo 
QR 
wR 
LO 
JF 


LO 
JR 


Lo 


Lo 
RET 


L,B 

H,0 

HL, HL 
BC, DOTSR 
HL, BC 


HL, DE 

A, CHL) 

HL 

H, HL) 
LA 

+4 

Z, BADOP 
A, (BDOATA) 
CHL) 


A, DEVERR 
EREXIT 


A, OPERR 


CIX+IOCEST),A 


3HL = 165-BIT OPERATION NUMBER 
sMULTIPLY BY 2 FOR ADDRESS ENTRIES 


3;HL = OFFSET TO SUBROUTINE IN 

7 DEVICE TABLE ENTRY 

;HL = ADDRESS OF SUBROUTINE 

7;GET SUBROUTINE ’S STARTING ADDRESS 


71S STARTING ADDRESS ZERO’ 
, UMP COPERATION INVALID 


DATA BYTE FOR WRITE 1 BYTE 
Q SUBROUTINE 


a4 


GC 


F;ERROR CODE -~ NO SUCH DEVICE 


sERROR CODE -~ NO SUCH GFERATICN 


7SET STATUS BYTE IN TOCE 


LSLAMKASKKCAKASMAGKCKMAKSMKCoKAGASMAKMAMAKKM KKM RMS ee eo ee 


;ROUTINE: INITOL 


*PURFOSEs 
sENTRY: 
sEXIT: 


NONE 


DEVICE LIST 


7;REGISTERS USED: 


INITIALIZE DEVICE LIST Ta EMPTY 
SET TO NO ITEMS 


SELKRRAMKKARK KAM KKK KM KMS KAK SMA MK ARK SRS Kee 


INI TOL: 


ADDL : 


DOVLST: 
EDATA: 


“us “S “aS “8 we “A “OQ WH we we 


CR 
LF 


BDCS 
CINP 
COUTF 
LOUTP 
RCEUF 
CSTAT 


SCi1ons 
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INITIALIZE DEVICE LIST HEADER Tao O TO INDICATE NO DEVICES 
LD HL, © SHEADER = O CEMPTY LIST) 

LD COVLST), HL 

RET 


BE BEDE Set Bb he; es ee pe Et oat wt be tp st eh ps ei ae eg EE Ew a Re EE Se 
FROUTINE: ADDOL 

;PURFOSE: ADD DEVICE To DEVICE LIST 

FENTRY: REGISTER HL = ADDRESS OF DEVICE TAGLE ENTRY 
,;EXIT: DEVICE ADDED Ta DEVICE LIST 

;REGISTERS USED: DE 

BE Ede pt Be se set He ot et i pe at pe Ee eS et et wi wh ei pw we EE wi a EH pL ew EE RE wi we 


Lo DE, (VLET) 7;GET CURRENT HEAD OF DEVICE LIST 
LD (HLI,E ;S70RE CURRENT HEAD OF DEVICE LIST 
INC HL ; INTO LINE FIELD OF NEW DEVICE 

Lo (HL), D 

DEC HL 

Lo (QVLST), HL MARE DVLST FOINT AT NEW DEVICE 
RET 


;DATA SECTION 
cs 2 ;DEVICE LIST HEADER 
DS L ;DATA BYTE FOR WRITE 1 BYTE 


=e 


SAMPLE EXECUTION: ; 
This test routine sets up the CP/M cansole as ? 
device 1 and the CP/M printer as device 2. 7 
The routine then reads a line fram the console and F 
echoes it to the console and the printer. 7 


sCHARACTER EGUATES 


EGU ODH ;CARRIAGE RETURN CHARACTER 

Emu OAH ;LINE FEED CHARACTER 

7;CF/M EQUATES 

Eft OO0SH FADDRESS OF CP/M BOOS ENTRY POINT 
EQU 1 ;EOOS CONSOLE INPUT FUNCTION 

Etat = 7;BOOS CONSOLE QUTFPUT FUNCTION 

Eu a ;BOOS LIST OUTPUT FUNCTION 

EGU 10 ;BOOS READ CONSOLE BUFFER FUNCTION 
EG 11 7;BDOS CONSOLE STATUS FUNCTION 


INITIALIZE DEVICE LIST, FOINT Ta IToce 
CALL INITOL INITIALIZE DEVICE LIST 
Lo TX, 1OCE FPOINT Ta TOce 


FSET UP CONSOLE AS DEVICE 1 AND INITIALIZE IT 
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TSTLP: 


EMH: 


LO 
CALL 
LT 
Lo 
CALL. 


7SET UP 
Lo 

CALL 

Lo 

Lo 

CALL. 


HL, CONDV sPOINT TO CONSOLE DEVICE ENTRY 
ADDL ;AD0D CONSOLE TO DEVICE LIST 
CIX+ICCBOP), INIT s INITIALIZE OPERATION 
CIX+ITOCBON), 1 ;DEVICE NUMBER = 1 


IGHDLR s INITIALIZE CONSOLE 

PRINTER AS DEVICE 2 AND INITIALIZE IT 

HL, PRTOV s;POINT TO PRINTER DEVICE ENTRY 
ADOOL ;ADD PRINTER TO DEVICE LIST 


CIX+IOQCBORP), INIT s INITIALIZE GFERATION 
CIX+TOCBON),2 ;DEVICE NUMBER = 2 
TOHDLR FINITIALIZE PRINTER 


;LOOP READING LINES FROM CONSOLE, AND ECHOING THEM TO 
; CONSOLE AND PRINTER UNTIL A BLANK LINE IS ENTERED 


Lt CIX+IOQCBOND), 1 ;DEVICE NUMBER = 1 (CONSOLE) 
ms (IX+IOCBOP),RNBYTE ; OPERATION IS REAG N BYTES 
LE HL, LENBLUPF 

Lo CIOCB+IOCBBL),HL 3;3SET BUFFER LENGTH TO LENBUF 
CALL. TOHDLR sREAD A LINE 

;QUTPUT LINE FEED TO CONSOLE 

Lo CIX+IOCBOP) ,WIBYTE ;QPERATION IS WRITE 1 BYTE 
LD A, LF s;CHARACTER IS LINE FEED 

CALL. TOHDLR ;WRITE 1 BYTE (LINE FEED) 
7;ECHO LINE TO DEVICE 1 AND 2 

Lo A, 1 

CALL ECHO s;ECHO LINE Tc DEVICE 1 

LD A,2 

CALL ECHO ;ECHO LINE TO DEVICE 2 


7S570P IF LINE LENGTH IS 06 


Lo 
Lo 
CR 
JR 


et R 


sQOUTPUT 
Lo 


LD 
CALL 


7 QUTPUT 
Lo 

Lo 

CALL 

Lo 

CALL 


HL, (IOCB+IOQCBEL) s:GET LINE LENGTH 


A,H ; TEST LINE LENGTH 

L 

NZ, TSTLF ;CONTINUE IF LENGTH NOT ZERO 
SC1LOD 7 AGAIN 

LINE 


CIX+10CBIN),A FSET DEVICE NUMBER IN ITOCE 

s;NOTE THAT ECHO WILL SEND A LINE 

; TO ANY DEVICE. THE DEVICE NUMBER 
>; I5 IN THE ACCLIMULATOR 

CIX+IOCBOF) ,WNBYTE ;SET OPERATION TO WRITE N BYTES 
IOHOLR ;WRITE N BYTES 


CARRIAGE RETURN/LINE FEED 
CIX+IQOCBOP) ,WIBYTE ;SET OPERATION TO WRITE 1 BYTE 


A, CR 7;CHARACTER IS CARRIAGE RETURN 
TOHDLR WRITE 1 BYTE 
A, LF sCHARACTER IS LINE FEED 


TOHDOLR ;WRITE 1 BYTE 


IOCEKs 


LENBLUF 
BUFFER: 


ONDVs: 


PRTOV: 


CINITs 


CISTAT: 


CiISi: 
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RET 


7IOCB FOR PERFORMING [7/0 


Ds 1 DEVICE NUMEER 

DS 1 ;ORFERATION NUMBER 
OS 1 ,STATUS 

CiW BUFFER ;BUFFER ADDRESS 
DS z 7; BUFFER LENGTH 

7 BUFFER 

EQu 127 

DS LENBUF 

DEVICE TABLE ENTRIES 


Cw 8) sLINK FIELD 

DB 1 sDEVICE 1 

DW CINIT SCONSOLE INITIALIZE 

Cw CISTAT sCONSOLE INPUT STATUS 

CiwW CIN ;CONSOLE INPUT 1 BYTE 

DW INN CONSOLE INFUT N BYTES 
Ciw COSTAT SCONSOLE OUTPUT STATUS 
DW COUT ;CONSOLE OUTPUT 1 BYTE 
CiW COLUTN SONSOLE OUTPUT N BYTES 
DW @) sLINK FIELD 

Dg 2 :DEVICE 2 

LiW PINIT sPRINTER INITIALIZE 

LW ‘) ;NO FRINTER INPUT STATUS 
LiW e) sNQ PRINTER INFUT 1 BYTE 
Ciw 0 sNO PRINTER INPUT N BYTES 
Cw POSTAT SPRINTER OUTPUT STATUS 
CiwW PCLT ‘PRINTER CGUTPUT 1 BYTE 
Ciw POLITN SPRINTER GUTFUT N BYTES 


{ERKKAARRREKAKKRARRK SRR Ree RE eS 
7;CONSOLE I/O ROUTINES 


;CONSOLE INITIALIZE 


PSTATUS = NC ERRCRS 
sNO INITIALIZATION NECESSARY 


;CONSOLE INPUT STATUS 


PUSH IX ;SAVE IOCE ADDRESS 

Lo C,CSTAT ;BOOS CONSOLE STATUS FUNCTION 

CALL BOOS 7;GET CONSOLE STATUS 

FOP IX ;RESTORE ITOCE ADDRESS 

CR A 

IR Z,CITSi sJUMPF IF NOT READY 

Lo A, DEVRIY ; INDICATE CHARACTER READY 

Lo CIX+IOCBSTI,A STORE STATUS AND LEAVE IT IN REGISTER A 
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TIN: 


CINN1 


;CONSOLE READ 1 BYTE 


PUSH IX 7SAVE IX 

Lo C, CINP 7;BDOS CONSOLE INPUT FUNCTION 
CALL BOOS 7;READ 1 BYTE FROM CONSOLE 
POP IX 7RESTORE IX 

RET 


;CONSOLE READ N BYTES 


s;READ LINE USING BOOS READ CONSOLE BUFFER FUNCTION 

;BOOS READ CONSOLE BUFFER FUNCTION USES THE FOLLOWING BUFFER FORMAT: 
BYTE O: BUFFER LENGTH (MAXIMUM NUMBER OF CHARACTERS) 

BYTE i: NUMBER OF CHARACTERS READ (LINE LENGTH) 

BYTES 2 GN: ACTUAL CHARACTERS 


@S ws “8 


PUSH IX 7;5AVE BASE ADDRESS OF IOCE 
Lo A, CIX+TOCBBL ) 7;GET BUFFER LENGTH 
SUB 3 ;BUFFER MUST GE AT LEAST 3 CHARACTERS 
3; TO ALLOW FOR MAXIMUM LENGTH AND COUNT 
; USED BY BDOS READ CONSOLE BUFFER 
wl NC, CINNI 7;JUMP IF BUFFER LONG ENQUGH 
LD CIX+IOCBST), BUFERR ;SET ERROR STATUS - BUFFER TOO SMALL 
RET 
INC A ;ADD GONE BACK TO DETERMINE HOW MUCH 
3; SPACE IS AVAILABLE IN BUFFER FOR DATA 
Lo E, CIX+ITOCBBA) 7;GET BUFFER ADDRESS FROM IOCE 
Lo DO, CIX+IOCWBBA+1 
PUSH DE. ;SAVE BUFFER ADDRESS 
LD (ORD, A 7;5ET MAXIMUM LENGTH IN BUFFER 
LOD C, RCBUF ;BOOS READ CONSOLE BUFFER FUNCTION 
CALL BOOS ;READ BUFFER 
;RETURN NUMBER OF CHARACTERS READ IN THE IOCE 
POF HL 7RESTORE BUFFER ADDRESS 
POP IX 7;RESTORE GASE ADDRESS OF ITOCE 
INC HL. ;FQINT TO NUMBER OF CHARACTERS REAL 
LD A, CHL) 7;GET NUMBER OF CHARACTERS READ 
Lo CIX+1TOCBBL),A ;SET BUFFER LENGTH IN IQCB 
Lo CIX+IOCBBL+1),0 ; WITH UPPER BYTE = © 


;MCVE DATA TO FIRST BYTE GF BUFFER 
;DROPPING OVERHEAD (BUFFER LENGTH, LINE LENGTH) 
; RETURNED BY CP/M. LINE LENGTH IS NOW IN THE IOCE 


OR A 3; TEST LINE LENGTH 
RET Z ;RETURN IF LENGTH WAS 0 
Lo CLA ;eC = NUMBER OF BYTES 
Lo E,0 
Lo 0H 7;POINT TO START GF BUFFER + 1 
LD EYL 
INC HL 7;HL = SOURCE = FIRST BYTE OF DATA 
; 2 BYTES BEYOND START 
DEC DE 70DE = DESTINATION (FIRST BYTE OF BUFFER) 
LOIR 7;MOVE DATA DOWN 2 BYTES IN BUFFER 


SUE A 7;STATUS = NO ERRORS 


COUT: 


COUTN: 


FINITs 


POSTAT: 


FUT: 


POLTN: 
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RET 

CONSOLE GUTPUT STATUS 

Lo A, DEVREY *STATUS = ALWAYS READY TO QUTFUT 
RET 

sCONSOLE GQUTFUT 1 BYTE 

PUSH IX sSAVE IX 

LD C,COUTP ;BOOS CONSOLE OUTPUT OPERATICN 
LO E,A sE = CHARACTER 

TALL Boas sQUTPUT 1 BYTE 

POF IX sRESTGRE IX 

SUB A sRETURN, NO ERRORS 

RET 

SCCONSOLE OUTPUT N BYTES 

Lo HL, COUT ‘HL POINTS Ta QUTPUT CHARACTER ROUTINE 
TALL QUTN sCALL GUTFLUT N CHARACTERS 

SUB & sSTATUS = NO ERRORS 

RET 

SHAK PHGKMKKMRAHMRAG HARARE 

SPRINTER ROUTINES 

Pett et eet ee te ee ee ee et ee St et te tt ee 

sFRINTER INITIALIZE 

SUE ray *NOTHING Ta D0, RETURN NO ERRORS 
RET 

sPRINTER QUTFPUT STATLIS 

Lo A, DEVROY sSTATUS = ALWAYS READY Ta GUTFUT 
RET 

*PRINTER QUTPUT 1 BYTE 

FLUSH IX sSAVE IX 

Lo , LOUTF sBoOdS LIST OUTPUT FUNCTION 

Lo E,A °E = CHARACTER 

CALL BOOS sQOUTFUT TO PRINTER 

FOF IX sRESTORE IX 

SUB A STATUS = NO ERRORS 

RET 

SPRINTER GUTPUT N BYTES 


LD HL, POUT 7;HL = ADDRESS OF OUTPUT ROUTINE 
CALL CHITN ;QUTPUT N CHARACTERS 
SUB A 3;NQ ERRORS 


RET 
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QUTNs 


QUTLP s 


DOSUBs 


i? 


ti} 


;ROUTINE: OUTN 

;PURPOSE: QUTPUT N CHARACTERS 

;ENTRY: REGISTER HL = CHARACTER OUTPUT SUBROUTINE ADDRESS 
; REGISTER IX = BASE ADDRESS OF AN IOCB 

sEXIT: DATA GUTPUT 

;REGISTERS USED: AF, BC ,HL 

J HAAR AAAAKA AGAR KKRKKE RRS RRR SRR 


7;STORE ADDRESS OF CHARACTER OUTPUT SUBROUTINE 
LD (COSR), HL 3;SAVE ADDRESS 


;GET NUMBER OF BYTES, EXIT IF LENGTH IS 0 
; BC = NUMBER OF BYTES 


Lo C, CIX+IOCBBL) 7;BC = BUFFER LENGTH 
LD B, CIX+IOCBBL+1) 

Lo A,B ;TEST BUFFER LENGTH 
CR Cc 

RET Zz s;EXIT IF BUFFER EMPTY 


3GET OUTPUT BUFFER ADDRESS FROM IOCB 
; HL = BUFFER ADDRESS 


Lo L, CIX+IOCBEA) ;HL = BUFFER ADDRESS 

Lo H, C(IX+ITOCBEA+1) 

LD A, CHL) 

PUSH HL ;SAVE BUFFER POINTER, COUNT 
PUSH BC 

CALL DOSUE ;QUTPUT CHARACTER 

POP BC ;RESTORE COUNT, BUFFER POINTER 
POP HL 

INC HL POINT TO NEXT CHARACTER 

DEC BC ;DECREMENT AND TEST COUNT 

LD A,B 

CIR C 

IR NZ, QUTLP s;CONTINUE UNTIL COUNT = 0 

RET 

LD HL, (COSR) 

IP CHL) 2G0TO ROUTINE 

CiwW 0 ;ADDRESS OF CHARACTER QUTPUT SUBROUTINE 


END 


Initialize 1/O Ports (PORTS) 


Initializes a set of I/O ports from an array of 
port device addresses and data values. Examples 
are given of initializing the common Z80 program- 
mable I/O devices: CTC, PIO, and SIO. 

This subroutine is a generalized method for 
initializing I/O sections. The initialization may 
involve data ports, data direction registers that 
determine whether bits are inputs or outputs, 
control or command registers that determine the 
operating modes of programmable devices, count- 
ers (in timers), priority registers, and other ex- 
ternal registers or storage locations. 

Tasks the user may perform with this routine 
include: 


1. Assigning bidirectional I/O lines as inputs 
or outputs 


2. Initializing output ports 


3. Enabling or disabling interrupts from 
peripheral chips 


4. Determining operating modes, such as 
whether inputs are latched, whether strobes 
are produced, how priorities are assigned, 
whether timers operate continuously or only on 
demand, etc. | 


5. Loading starting values into timers and 
counters 


6. Selecting bit rates for communications 


7. Clearing or resetting devices that are not 
tied to the overall system reset line 


8. Initializing priority registers or assigning 


NOE 


Registers Used: AF, BC, DE, HL 


Execution Time: 22 cycles overhead plus 46+ 21 * N 
cycles for each port, where N is the number of bytes 
sent. 


Program Size: || bytes plus the size of the table (at 
least 3 bytes per port plus | byte for a terminator) 


Data Memory Required: None 





initial priorities to interrupts or other opera- 
tions 


9. Initializing vectors used in servicing 
interrupts, DMA requests, and other inputs. 

Procedure: For each port, the program obtains 
the number of bytes to be sent and the device 
address. It then sends the data values to the port 
using a repeated block output instruction. This 
approach does not depend on the number or 
type of devices in the I/O section. The user may 
add or delete devices or change the initialization 
by changing the array rather than the program. 
Each entry in the array consists of a series of 
byte-length elements in the following order: 


1. Number of bytes to be sent to the port 
2. 8-bit device address for the port 
3. Data bytes in sequential order. 


The array ends with a terminator that has 0 in 
its first byte. 

Note that an entry may consist of an arbitrary 
number of bytes. The first element determines 
how many bytes are sent to the device address in 
the second element. The subsequent elements 
contain the data values. The terminator need 
consist only of a single 0 byte. 





Entry Conditions 


Base address of initialization array in HL 


Exit Conditions 


All data values sent to appropriate ports 
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Example 


1. Data: Array elements are Result: 
3 (number of bytes for port 1) 
Port | device address, first value, second 
value, third value 
2 (number of bytes for port 2) 
Port 2 device address, first value, second 
value 
4 (number of bytes for port 3) 
Port 3 device address, first value, second 
value, third value, fourth value 
0 (terminator) 
; Title Initialize I/0 FPerts 
; Names: IPORTS. 
: Furposes Initialize I/Q ports fram an array of part 
; addresses and values 
: Entry: Register pair HL = Base address of array 
- The array consists of byte-length elements 
; in the following orders: 
7 be sent to the port, 
; Values for the part. 
. for any number of ports. 
; by an entry with O in the 
: arraytO = Number of bytes for 
. arrayti = Port device address 
; arrayt2 = First value for this port 
: arrayt2+¢(N-1) = Last value far 
; Exit: None 
’ Registers used: AF, BC, DE, HL 
: Time: 22 cycles overhead plus 46 + (N ® 21) 
; each part, 


port device address; 
This sequence is repeated 


where N is the number of bytes sent 


Three values sent to port 1’s device address 
Two values sent to port 2’s device address 
Four values sent to port 3’s device address 


“ws “5S we “Ss “8 


“us wa we 


number of bytes ta 
data 


The array is terminated 
number of bytes. 
this port 


this part 


mycles for 


“8 “e “8 «ws “6 “ea “<8 we “8S we “8S “es “Ss “ws “VS we “WE uA NE WS NS we “WB “EH WE NE NS ONE 
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Froeogram il bytes 


<< ue “8 we 
8) 
» 
bat | 
TG 
ee 


=s “we “SB wa 


IPORTS: 
7GET NUMBER OF DATA BYTES Ta SEND Ta CURRENT PORT 
ZSEXIT IF NUMBER OF BYTES IS 0, INDICATING TERMINATOR 


Lf A, CHL) ;GET NUMBER GF BYTES 

CIR A ,TEST FOR ZERO (TERMINATOR) 

RET Z 7;RETURN IF NUMBER OF BYTES = 0 

Lo B,A 

INC HL. sPOINT TO PORT ADDRESS (NEXT BYTE) 


70 = PORT ADDRESS 
7;HL = ADDRESS OF DATA TQ OUTPUT 


0 , CHL) SHEET FORT ADDRESS 
INC HL. sFOINT Ta FIRST DATA VALUE (NEXT BYTE) 
SQUTPLUT DATA AND CONTINUE TO NEXT FORT 
QTIR sSEND DATA VALUES TQ PORT 
IR IFORTS sCONTINUE Ta NEXT PORT ENTRY 
: SAMPLE EXECUTION: . 
s INITIALIZE 
; ZO CTC CPROGRAMMABLE TIMER/COUNTER) 
, £80 SIQ CPROGRAMMABLE SERIAL INTERFACE) 
>; Z5BO FIC CPROGRAMMABLE FARALLEL INTERFACE) 
‘AREITRARY FORT ADDRESSES 
: €TC PORT ASSIGNMENTS 
CTA Ett 7OH sCTC CHANNEL O 
CTC. Emu 71H s(TC CHANNEL 1 
CTt2 Ett 72H CTC CHANNEL 2 
CTCs EU 73H s([TC CHANNEL 3 
s SIQ FORT ASSIGNMENTS 
SIQCAD EDU SOH :S1I0 CHANNEL A LIATA 
SIQCEOH Emu S1H °SI0Q} CHANNEL B&B DATA 
SIOCAS Ent SoH S10 CHANNEL A CCOIMMANDS/STATUS 
SIQCBS EOQu S3H °SIQ CHANNEL E COMMANDS/STATUS 
:s PIC PORT ASSIGNMENTS 
FICQAL EGU OF OH *FICQ FORT A DATA 
FICE Emu OF 1H :PIGQ PORT B DATA 
PIGAC EQu OF 2H ‘FIG FORT A CONTROL 
FICEC EQu OF 3H ®=PIO PORT B CONTROL 
; INTERRUPT VECTORS 
SIQIV EGU OlOH :S10 INTERRUPT VECTOR 
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PIQIVA EQu OLIOH FIC PORT A INTERRUPT VECTOR 
PIGIVB Emu OO2H :PIC PORT B INTERRUPT VECTOR 
SCLIOE: 
LO HL,PINIT *POINT TO INITIALIZATION ARRAY 
CALL IFORTS s INITIALIZE FORTS 
JR SCIOE 
PINIT: 


INITIALIZE ZO CTC CHANNEL 0 
RESET CHANNEL 
QOPERATE CHANNEL IN COUNTER MODE, DECREMENTING DOWN COUNTER 
AFTER EACH POSITIVE CRISING) EDGE ON CLOCK INPUT. 
SET INITIAL TIME CONSTANT TO 2é CLOCK CYCLES. 
NOTE: CTC RELOADS TIME CONSTANT REGISTER INTO DOWN COUNTER 
AUTOMATICALLY AFTER EACH COUNTDOWN TO OQ. 


—s “8 ws “NS ws ~s ~S 


THIS INITIALIZATION PRODUCES AN SIOQ CLOCK FOR 9600 BALID 


; TRANSMISSION. 
7 IT ASSUMES 4 MHZ CLOCK INPUT TO FIN 23, SO A COUNT OF 
; 4,000, 000/(16297600) = 26 WILLL GENERATE A 153, 600 
; (1689600) HZ SQUARE WAVE ON PIN 7 FOR SIQ PINS 13 AND 14. 
; S10 IS QPERATING IN DIVIDE BY 16 MODE. 
DE 2 sQUTPUT TWO BYTES 
Wt CTCO DESTINATION IS CHANNEL CONTROL REGISTER 
DG O1O1O111E ;BIT O = 1 CWRITE CHANNEL CONTROL WORD) 
7;BIT 1 = 1 (RESET CHANNEL) 
BIT 2 = 1 (TIME CONSTANT FOLLOWS) 
7;BIT 3S = O (NOT USED IN COUNTER MODE) 
BIT 4 = 1 (DECREMENT COUNTER ON 
7 POSITIVE CLOCK EDGE) 
;BIT 3S = 0 (NOT USED IN COUNTER MODE) 
EIT & = 1 (COUNTER MODE) 
;BIT 7 = O (NO INTERRUPT) 
DE Gs TIMER COUNTDOWN VALUE FOR 9600 BAUD 


INITIALIZE ZS0 SIO CHANNEL A FOR ASYNCHRONOUS SERIAL I/d. 

SET INTERRUPT VECTOR CALWAYS IN CHANNEL B) Tao SIOTV 

NO PARITY, 2 STOP BITS, 16 TIMES CLOCK. 

RECEIVE AND TRANSMIT & BITS/CHAR, NO SPECIAL CONTROLS. 
ENABLE TRANSMIT INTERRUPT, RECEIVE INTERRUPTS ON ALL CHARS; 
PARITY QR STATUS DOES NOT AFFECT INTERRUPT VECTORS. 


-ws 86 648 SSB OME 


SET INTERRUPT VECTOR 

DE a : FOUTPUT TWO BYTES 

DE SIOCBS ;DESTINATION IS COMMAND REGISTER B 
DB 0000001 0E ;SELECT WRITE REGISTER 2 

De SIOIV ;SET INTERRUPT VECTOR FOR SIO 

; INITIALIZE CHANNEL A 

ao: ef ;OUTPUT NINE BYTES 


DG SIOCAS sDESTINATION IS COMMAND REGISTER A 


OG 


e <= 


DG 
ac: 


“a 68 


DB 


“as wes 


DG 


rT “68 0 6~we “8S uS 64S 
md 


m 
tH 


a 
De 
a 
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RESET THE CHANNEL 

0001 1000B 7;SELECT WRITE REGISTER O 
;BITS 2,1,0 O (WRITE REGISTER 0) 
7BITS 5,4,2 O11 (CHANNEL RESET) 
7;BITS 7,6 = 0 (DO NOT CARE) 


2) 


INITIALIZE BAUD RATE CONTROL 
NO PARITY, 2 STOP BITS, 16 TIMES CLOCK 


QOOOOLO0B ;SELECT WRITE REGISTER 4 
010011008 ;BIT 0 = O (NO PARITY) 
7;BIT 1 = 0 (DON’T CARE) 


;BITS 3,2 = 11 (2 STOP BITS) 
7;BITS 3,4 = 00 (DON’T CARE) 
;BITS 7,6 = O1 (16 TIMES CLOCK) 


INITIALIZE RECEIVE CONTROL 
$3 BITS PER CHARACTER, ENABLE RECEIVER, NO AUTO ENABLE 


QQOOOOOLIB ;SELECT WRITE REGISTER 2 
11100001B ;BIT O = 1 (RECEIVE ENABLE) 


7;BITS 4,3,2,1 = O (DON’T CARE) 
BIT 3 = O (NO AUTO ENABLE) 
BIT 7,6 = 11 CRECEIVE & BITS/CHAR) 


INITIALIZE TRANSMIT CONTROL 
@ BITS FER CHARACTER, ENABLE TRANSMIT, NO BREAK GR CRC 


QOOOOO1LO1E ;SELECT WRITE REGISTER 3 
111010106 7;BIT O = O (NO CRO GN TRANSMIT) 
:BIT £ = L CREGQUEST To SEND) 
BIT 2 = O (DON'T CARE) 
?BIT os = 1 (TRANSMIT ENABLE) 
>BIT 4 = 0 (D0 NOT SEND BREAK) 
*BITS 6,2 = 11 (TRANSMIT & BITS/CHAR) 
;BIT 7 = 1 (DATA TERMINAL READY) 


INITIALIZE INTERRUFT CONTROL 


RESET INTERRUPTS FIRST 
ENABLE TRANSMIT INTERRUPT, RECEIVE INTERRUPTS ON ALL. CHARS 
NEITHER STATUS NOR PARITY ERRORS AFFECT INTERRUPT VECTOR 
DO NOT CONTROL THE WAIT/READY OUTPUT LINE 
OOOLOOO1B ;SELECT WRITE REGISTER 1 AND 
; RESET EXTERNAL/STATUS INTERRUPTS 
QOOOLLOLOB BIT © O (NO EXTERNAL INTERRUFTS ) 
sEIT 1 1 (ENABLE TRANSMIT INTERRUPT) 
;BIT 2 O (STATUS DOES NOT AFFECT 
; VECTOR) 
34,3 = 11 (RECEIVE INTERRUPTS ON 
ALL CHARS, PARITY DOES NQT 
AFFECT VECTOR) 
BITS 7,6,5 = 000 (NO WAIT/READY 
FUNCT ICN) 


re] 
a 
+ 


J 


wa «wa 6‘“NS MS 


TRANSMIT A NULL BYTE TO START INTERRUPT PROCESSING 
1 ;OUTFUT 1 BYTE 

SIOCAL ;DESTINATION IS CHANNEL A DATA 

0 ;NULL CHARACTER (00 HEX) 
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;INITIALIZE ZSo FIC 


=e vs “8S NA 


DB 
DE 
DB 
DB 


DB 
? 

DB 
DE 


DE 
i 


DB 


DB 


DE 


END 


PORT A - INPUT PORT WITH INTERRUPT ENABLED 
PORT B - CONTROL PORT WITH INTERRUPT ENABLED. AN INTERRUPT IS 
GENERATED IF ANY OF BITS ©, 4, OR 7 BECOME 1 


INITIALIZE PIQ PORT A 


3 ;QUTPUT 3 BYTES 

PIQAC s;DESTINATION IS PORT A CONTROL 
PIQIVA 3SET INTERRUPT VECTOR FOR PORT A 
1OOO11LIB 7;BITS 3,2,1,0 = 1111 (MODE SELECT) 


s;BITS 3,4 = 00 (DON’T CARE) 
;BITS 7,6 = O1 CINFUT MODE) 
10000111B BITS 3,2,1,0 = O111 CINTERRUPT CONTROL) 


;BITS 6,5,4 = 000 (DON’T CARE) 
7;BITS 7 = 1 CENABLE INTERRUPTS) 
INITIALIZE PIG FORT B 
4 ;QUTPUT 4 BYTES 
PIOBC ;DESTINATION IS PORT B CONTROL 
PIOIVB 7;5ET INTERRUPT VECTOR FOR PORT & 
110011116 ;BITS 3,2,1,0 = 1111 (MODE SELECT) 


BITS 5,4 = 00 (DON’T CARE) 

7;BITS 7,6 = 11 (CONTROL MODE) 
LOLIOLLIG ;BITS 3,2,1,0 = O111 CINTERRUPT CONTROL) 

7;b1T 4 = 1 (MASK FOLLOWS) 

3;BIT 5S = 1 CACTIVE STATE ON MONITORED 

; INPUT LINES IS 1 FOR AN INTERRUPT) 

sBIT 6 = O CINTERRUPT IF ANY OF THE 

; MONITORED INPUT LINES IS ACTIVE) 

7BIT 7 = 1 CENABLE INTERRUPTS) 
10010001B MONITOR INPUT BITS 0, 4, AND 7 

; FOR INTERRUFTS 


END OF PORT INITIALIZATICN DATA 
Q ; TERMINATOR 


Delay Milliseconds (DELAY) 


Provides a delay of between | and 256 milli- 
seconds, depending on the parameter supplied. 
A parameter value of 0 is interpreted as 256. The 
user must calculate the value CPMS (cycles per 
millisecond) to fit a particular computer. Typical 
values are 2000 for a 2 MHz clock, 4000 for a 
4 MHz clock, and 6000 for a 6 MHz clock. 

Procedure: The program simply counts down 
register B for the appropriate amount of time as 
determined by the user-supplied constant. Extra 


Entry Conditions 


Number of milliseconds to delay (1 to 256) in A 


Example 


1. Data: 
Result: 


(A)= number of milliseconds = 2A j¢ (42)9) 
Software delay of 2A,,¢ milliseconds, with 
proper CPMS supplied by user 


<a «es “8 ~s “8 se “8 wes 


Delay from 1 ta 2546 milliseconds 


Register A = Number of milliseconds ta delay 
A © equals 254 millisecands 


Registers Used: AF 
Execution Time: | ms * (A) 
Program Size: 51 bytes 


Data Memory Required: None 
Special Case: (A) = 0 causes a delay of 256 ms 





instructions account for the CALL instruction, 
RET instruction, and routine overhead without 
changing anything. 


Exit Conditions 


Returns after the specified delay with (A) = 0 


=2 ws “8S we “8 “WS “SB “A 


Returns to calling routine after the 
specified delay 


Title Delay milliseconds 
Name: Delay 

. Furpases 

: Entrys 

: Exits 


“8 “eae “8 ws ws we “8S we 
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CPMS 


DELAY s 


LOLF: 


LOLY1: 
LILYas 
LOLY 3: 


Registers used: AF 


Times 1 millisecond # Register A, 
Sizes Fraogram Sil bytes 
s*EQUATES 
;CYCLES PER MILLISECOND -— USER-SUPPLIED 
Emu 4000 s2000 = 2 MHZ CLOCK 

*4000 = 4 MHZ CLOCK 

24000 = 6&6 MHZ CLOCK 
ME THOT: 


THE ROUTINE IS DIVIDED INTO 2 PARTS. THE CALL TO 
THE "DLY" ROUTINE DELAYS EXACTLY 1 LESS THAN THE 
REQUIRED NUMBER OF MILLISECONDS. THE LAST ITERATION 
TAKES INTO ACCOUNT THE OVERHEAD TO CALL "DELAY" AND 
"DLY". THIS OVERHEAD IS: 


17 CYCLES ==> CALL DELAY 

11 CYCLES ==> PUSH BC 

17 CYCLES ==> CALL DLY 

4 CYCLES ==> DEC A 

11 CYCLES ==> RET Z 

7 CYCLES ==> LD B, (CPMS/100)-1 
10 CYCLES ==> POP BC 

13 CYCLES ==> LD A, (DELAY) 

10 CYCLES ==> RET 


100 CYCLES OVERHEAD 


“=a @8 ve “8S we “SS we “WS ws “8S ws MS ve “8 wa “NE WS 


700 ALL BUT THE LAST MILLISECOND 

317 CYCLES FOR THE USER’S CALL 
711 CYCLES 

332 CYCLES TO RETURN FROM DLY 


PUSH BC 
CALL DLY 


700 2 LESS THAN 1 MILLISECOND FOR OVERHEAL 
_D B,+CCPMS/50)—-2 37 CYCLES 


| 


267 CYCLES 


IF LOL Y 1 710 CYCLES 
IP LOLY2 710 CYCLES 
JP LOLYS 710 CYCLES 
ADD A,Q 77 CYCLES 


DINZ LOLF 713 CYCLES 


750 CYCLES 
;EXIT IN 33 CYCLES 

POP BC 710 CYCLES 
LD A, (DELAY? 313 CYCLES 


<2 “8 we “8 we “8 “SB 


10F DELAY MILLISECONDS (DELAY) 393 


RET 0 CYCLES 


1 
33 CYCLES 


8 
t 
® 
? 
s 
? 


SSHAAKPKS GSR SRR RR ee 
;ROUTINE: DLY 

;PURPOSE: DELAY ALL BUT LAST MILLISECOND 

;ENTRY: REGISTER A = TOTAL NUMBER OF MILLISECONDS 
s;EXIT: DELAY ALL BUT LAST MILLISECOND 

;REGISTERS USED: AF, EC, HL 

J HRSG ETS Ree RRR 


OLY: 
DEC: A 24 CYCLES 
RET Z 2S CYCLES (RETURN WHEN [IGNE 11 CYCLES) 
Lo B,+(CPMS/50)-1 +7 CYCLES 
216 CYCLES 
DLP: 
JP DLY1 510 CYCLES 
DLYi: JP DLY2 510 CYCLES 
ULY2: JP DLYS 210 CYCLES 
DLY2: ADD A,O 27 CYCLES 
CiINZ ULF 513 CYCLES 
s50 CYCLES 
“EXIT IN 24 CYCLES 
JF nLY4 510 CYCLES 
DLY4: JF DLYS 310 CYCLES 
LYS: NOP 24 CYCLES 
JP DILY 510 CYCLES 
524 CYCLES 
: SAMPLE EXECUTION: : 
SCLOF: 
| DELAY 10 SECONDS 
> CALL DELAY 40 TIMES AT 250 MILLISECONDS EACH 
Lo B, 40 240 TIMES (28 HEX) 
QTRSCD: 
Lo A, 250 2250 MILLISECONDS (FA HEX) 
CALL DELAY 
ChINZ TRECH SCONTINUE UNTIL DONE 
IR SCLOF 


END 


Unbuffered Input/Output 


Using an SIO (SINTIO) 


Performs interrupt-driven input and output 
using an SIO and single-character input and 
output buffers. Consists of the following sub- 
routines: 


1. INCH reads a character from the input 
buffer. 


2. INST determines whether the input buffer 
is empty. 


3. OUTCH writes a character into the output 
buffer. 


4. OUTST determines whether the output 
buffer is full. 


5. INIT initializes the SIO, the interrupt 
vectors, and the software flags. The flags are 
used to manage data transfers between the main 
program and the interrupt service routines. 


The actual service routines are 


1. RDHDLR responds to the input interrupt 
by reading a character from the SIO into the 
input buffer. | 


2. WRHDLR responds to the output interrupt 
by writing a character from the output buffer 
into the SIO. 


Procedures 


1. INCH waits for a character to become 
available, clears the Data Ready flag (RECDF), 
and loads the character into the accumulator. 


2. INST sets Carry from the Data Ready flag 
(RECDF). 


3. OUTCH waits for the output buffer to 
empty, stores the character in the buffer, and 
sets the Character Available flag (TRNDF). If 
no output interrupt is expected (i.e., the interrupt 
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Registers Used: 
. INCH: AF 
. INST: AF 
. OUTCH: AF 
. OUTST: AF 
. INIT: AF, BC, HL, I 
Execution Time: 
1. INCH: 72 cycles if a character is available 
2. INST: 27 cycles 


3. OUTCH: 150 cycles if the output buffer is not 
full and an output interrupt is expected; 75 additional 
cycles to send the data to the SIO if no output 


interrupt is expected. 
4. OUTST: 27 cycles 
5. INIT: 618 cycles 
6. RDHDLR: 82 cycles 
7. WRHDLR: 160 cycles 
Program Size: 202 bytes 


Data Memory Required: 5 bytes anywhere in 
RAM for the received data (address RECDAT), 
Receive Data flag (address RECDF), transmit data 
(address TRNDAT), Transmit Data flag (address 
TRNDF), and Output Interrupt Expected flag ad- 
dress OIE) 





has been reset because it occurred when no 
data was available), OUTCH sends the data to 
the SIO immediately. 


4. OUTST sets Carry from the Character 
Available flag (TRNDF). 


5. INIT clears the software flags, sets up the 
interrupt vectors, and initializes the SIO by 
placing the appropriate values in its control 
registers. See Subroutine IOE for more details 
about initializing SIOs. 


6. RDHDLR reads the data, saves it in the 
input buffer, and sets the Data Ready flag 
(RECDF). 
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7. WRHDLR determines whether data is 
available. If not, it simply resets the output 
interrupt. If data is available, the program sends 
it to the SIO and clears the Character Available 
flag (TRNDF). 


The special problem here is that an output 
interrupt may occur when no data is available. 
It cannot be ignored or it will assert itself 
indefinitely, causing an endless loop. The solution 
is simply to reset the SIO’s transmit interrupt 
without sending any data. 

But now a new problem arises when output 
data becomes available. That is, since the 
interrupt has been reset, it obviously cannot 
inform the system that the SIO is ready to 
transmit. The solution is to have a flag that 
indicates (with a 0 value) that the output 
interrupt has occurred without being serviced. 
This flag is called OIE (Output Interrupt 
Expected). 


Entry Conditions 


1. INCH: none 

2. INST: none 

3. OUTCH: character to transmit in A 
4. OUTST: none 

5. INIT: none 


Title 


Names: SINTIO 


“8 “se we wea “8 “WS SS hE 


Simple interrupt input and output using an SIO 
and single character buffers 


The initialization routine clears OIE (since 
the SIO surely starts out ready to transmit). The 
output service routine clears it when an output 
interrupt occurs that cannot be serviced (no 
data is available) and sets it after sending data to 
the SIO (in case it might have been cleared). 
Now the output routine OUTCH can check OIE 
to determine whether an output interrupt is 
expected. If not, OUTCH simply sends the data 
immediately. 

Note that an SIO interrupt can be reset 
without actually sending any data. This is not 
possible with a PIO (see Subroutine 11B), so the 
procedure there is slightly different. 

Unserviceable interrupts occur only with 
output devices, since input devices always have 
data ready to transfer when they request service. 
Thus, output devices cause more initialization 
and sequencing problems in interrupt-driven 
systems than do input devices. 


Exit Conditions 


1. INCH: character in A 


2. INST: Carry = 0if input buffer empty, 1 if 
full 


3. OUTCH: none 


4. OUTST: Carry= 0 if output buffer empty, 
1 if full 


5. INIT: none 


“wea ws 


we “8 “ae “ae “8 WE 
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Purposes 


“se “6 “2 SB OSS 


Entry: 


Exits 


wa “S “Ss “8 “NS “WE UWS WS WE WE VB ONS WS Ne we UMS UNO NE NS UNE UNS UNS NS ME UNS NSE UNS USS NS ws MS WS ws WS NS ONS 


Registers used: 


Times 


we M8 MS «SS eS wa 6 “8 “8s ws NS WS 


This program cansists af 5 subroutines which 
perform-interrupt driven input and output using 
an SIQ. 


INCH 
Read a character 
INST 
Determine input status (whether input 
buffer is empty) 
OUTCH 
Write a character 
OUTST 
Determine output status (whether output 
buffer is full) 
INIT 
Initialize SIO and interrupt system 


INCH 
No parameters 
INST 
No parameters 
OUTCH 
Register A = character to transmit 
OUTST 
No parameters 
INIT 
No parameters 


INCH 
Register A = character 
INST 
Carry = O if input buffer is empty, 
1 if character is available 
OUTCH 
No parameters 
OUTST 
Carry = O if output buffer is not 
full, i if it is full 
INIT 
No parameters 


INCH -— AF 
INST — AF 
QUTCH - AF 
QUTST - AF 


INCH 

72 cycles if a character is available 
INST 

27 cycles 


“uz “8 “@ “® ws ss ws ws “Oe “8 “AQ “Se “SS WS US NS YS UH MN NR NS WE NS Net Ne we NS ME MS MEH US US NS NE WA NS WS OMS US SEROUS Me WE OS NS ONE VE Ne MS NS Oe 


Ws 
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STOQcAD 
STOCBD 
STOCAS 
STOCBS 
SIOIV 
STOWV 
SIOEV 


SIORV 
SIOSV 


INCH: 


INST: 
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OUTCH 
150 cycles if output buffer is not full 
and output interrupt is expected 
QUTST 
27 cycles 
INIT 
618 cycles 
RDHDLR 
S2 cycles 
WRHDLR 
160 cycles 


Size: Program 202 bytes 
Data = bytes 


SIO EQUATES 
S1Q IS PROGRAMMED FOR: 
ASYNCHRONOUS OPERATION 
16 X BAUD RATE 
8-BIT CHARACTERS 
1 1/2 STOP BITS 
s; ARBITRARY SIO PORT ADDRESSES 


we “us “Ss “VS NS US 


EQU iCH 7S10Q CHANNEL A DATA 

EQU 1EH 7SIQ CHANNEL B DATA 

EQui iDH 7SIQ CHANNEL A COMMANDS/STATUS 

EQU 1FH 3;SIO CHANNEL B COMMANDS/STATUS 

EQU 8000H 7 INTERRUPT VECTOR 

EQU STOIV+S SIO CHANNEL A WRITE INTERRUPT VECTOR 

EQU STOTV+10 7;SIQ CHANNEL A EXTERNAL/STATUS INTERRUPT 
; VECTOR 

EQu STIOIV+i2 7STQ CHANNEL A READ INTERRUPT VECTOR 

EQU STOTV+14 7SIQ CHANNEL A SPECIAL RECEIVE INTERRUPT 
; VECTOR 


7;READ CHARACTER 


CALL INST 7;GET INPUT STATUS 

JR NC, INCH s;WAIT IF NO CHARACTER AVAILABLE 
DI DISABLE INTERRUPTS 

SUB A 

LD CRECDF),A 7; INDICATE INPUT BUFFER EMPTY 

LD A, (RECDAT) 3;GET CHARACTER FROM INPUT BUFFER 
EI s;ENABLE INTERRUPTS 

RET 


7;RETURN INPUT STATUS (CARRY = 1 IF INPUT DATA IS AVAILABLE) 


LD A, (RECDF) GET DATA READY FLAG 
RRA 7SET CARRY FROM DATA READY FLAG 
> IF CARRY = 1, CHARACTER IS AVAILABLE 
RET 
s;WRITE CHARACTER 


we “58 “WS “SG “RB UE We ws WS “NS VR WA US NS UE OMS 
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QUTCHs 


WAITOC: 


QUTST: 


INIT: 


PUSH AF 7;SAVE CHARACTER TO WRITE 
s;WAIT FOR CHARACTER BUFFER TO EMPTY, THEN STORE NEXT CHARACTER 


CALL OUTST sGET OUTPUT STATUS 

JR C,WAITOC sWAIT IF OUTPUT BUFFER IS FULL 

DI DISABLE INTERRUPTS WHILE LOOKING AT 
3 SOFTWARE FLAGS 

POP AF ;GET CHARACTER 

LD (TRNDAT),A s;STORE CHARACTER IN OUTPUT BUFFER 

LD A, OFFH INDICATE OUTPUT BUFFER FULL 

LD (TRNDF),A 

LD A, (OIE) ?;TEST OUTPUT INTERRUPT EXPECTED FLAG 

OR A 

CALL Z, QUTBDAT sQUTPUT CHARACTER IMMEDIATELY IF 
; NO OUTPUT INTERRUPT EXPECTED 

EI s;ENABLE INTERRUPTS 

RET 


s;QUTPUT STATUS (CARRY = 1 IF OUTPUT BUFFER IS FULL) 


LD A, (TRNDF ) 3;GET TRANSMIT FLAG 
RRA 3;SET CARRY FROM TRANSMIT FLAG 
RET ; CARRY = 1 IF BUFFER FULL 


INITIALIZE INTERRUPT SYSTEM AND SIO 


DI ;DISABLE INTERRUPTS FOR INITIALIZATION 
s INITIALIZE SOFTWARE FLAGS 

SUB A 

LD CRECDF),A 7NO INPUT DATA AVAILABLE 

LD CTRNDF),A ;OUTPUT BUFFER EMPTY 

LD (OIE),A sNO QUTPUT INTERRUPT EXPECTED 


; SIO IS READY TO TRANSMIT INITIALLY 
s INITIALIZE INTERRUPT VECTORS 


LD A,SIOIV SHR & s;GET INTERRUPT PAGE NUMBER 

LD I,A ;SET INTERRUPT VECTOR IN Z80 

IM 2 s INTERRUPT MODE 2 - VECTORS IN TABLE 
; ON INTERRUPT PAGE 

LD HL, RDHDLR s;STORE READ VECTOR CINPUT INTERRUPT) 

LD (STORV),HL 

LD HL, WRHDLR sSTORE WRITE VECTOR (OUTPUT INTERRUPT) 

LD (STOWV), HL 

LD HL, EXHDLR s;STORE EXTERNAL/STATUS VECTOR 

LD (STOEV),HL 

LD HL, REHDLR 7;STORE RECEIVE ERROR VECTOR 

LD (STOSV),HL 

sINITIALIZE SIO 

LD HL, SIOINT 3;GET BASE OF INITIALIZATION ARRAY 

CALL IPORTS sINITIALIZE SIO 

EI ;ENABLE INTERRUPTS 


RET 


ROHDLR: 


RD1: 


WRHDLR: 


NODATA: 


WRDONE : 


EXHDLR: 
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;INFUT CREAD) INTERRUPT HANDLER 


PUSH AF 7;SAVE AF 

IN A, (STOCAD) ;READ DATA FROM SIO 

LD (RECDAT),A ;SAVE DATA IN INPUT BUFFER 

LD A, OFFH 

LD (RECDF),A s INDICATE INPUT DATA AVAILABLE 
POP AF sRESTORE AF 

EI ;REENABLE INTERRUPTS 

RET I 


sQUTPUT CWRITE) INTERRUPT HANDLER 


PUSH AF 

LD A. (TRNDF ) :GET DATA AVAILABLE FLAG 
RRA 

JR NC, NODATA sJUMP IF NO DATA TO TRANSMIT 
CALL QUTDAT s;OUTPUT DATA TO SIO 

JR WRDONE 


;IF AN OUTPUT INTERRUPT OCCURS WHEN NO DATA IS AVAILABLE. 

WE MUST RESET IT TO AVOID AN ENDLESS LOOP. LATER. WHEN A 
CHARACTER BECOMES AVAILABLE, WE NEED TO KNOW THAT AN OUTPUT 
INTERRUPT HAS OCCURRED WITHOUT BEING SERVICED. THE KEY HERE 
TS THE QUTPUT INTERRUPT EXPECTED FLAG OIE. THIS FLAG IS 
CLEARED WHEN AN OUTPUT INTERRUPT HAS OCCURRED BUT HAS NOT 

BEEN SERVICED. IT IS ALSO CLEARED INITIALLY SINCE THE 

SIQ STARTS OUT READY. OIE I[S SET WHENEVER DATA IS ACTUALLY 
SENT TO THE SIO. THUS THE OUTPUT ROUTINE OQUTCH CAN CHECK 

OIE TO DETERMINE WHETHER TO SEND THE DATA IMMEDIATELY 

QR WAIT FOR AN QUTPUT INTERRUPT. 
THE PROBLEM IS THAT AN QUTPUT DEVICE MAY REQUEST SERVICE BEFORE 
THE COMPUTER HAS ANYTHING TO SEND CUNLIKE AN INPUT DEVICE 

THAT HAS DATA WHEN IT REQUESTS SERVICE). THE OIE FLAG 

SOLVES THE PROBLEM OF AN UNSERVICED OUTPUT INTERRUPT ASSERTING 
ITSELF REPEATEDLY, WHILE STILL ENSURING THE RECOGNITION OF 
QUTPUT INTERRUPTS. 
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SUB A 

LD (OIE),A sDO NOT EXPECT AN INTERRUPT 

QUT (STQCAS),A ;SELECT REGISTER 0 

LD A,00101000B sRESET SIO TRANSMITTER INTERRUPT 
QUT (SIOCAS),A 

POP AF sRESTORE AF 

EI 

RET I 


sEXTERNAL/STATUS CHANGED INTERRUPT HANDLER 


PUSH AF 
LD A,00010000B FRESET STATUS INTERRUPT 
OUT (STOQCAS).A 


EI ;DCD OR CTS CHANGED STATE, OR A BREAK 
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REHDLR: 


QUTDAT = 


IPORTS: 


POP AF > WAS DETECTED 

RETI sSERVICE HERE IF NECESSARY 
;SPECIAL RECEIVE ERROR INTERRUPT 

PUSH = AF 

LD A,00110000B ;RESET RECEIVE ERROR INTERRUPT 
QUT (SIOCAS), A 

EI :FRAMING ERROR OR OVERRUN ERROR 
POP AF ; OCCURRED 

RETI ;SERVICE HERE IF NECESSARY 


sROUTINE: OUTDAT 

;PURPOSE: SEND CHARACTER TO SIO 
sENTRY: TRNDAT = CHARACTER 
sEXIT: NONE 

REGISTERS USED: AF 


LD A, (TRNDAT) GET DATA FROM OUTPUT BUFFER 

QUT (STOCAD).A ?SEND DATA TO SIO 

SUB A s INDICATE OUTPUT BUFFER EMPTY 

LD (TRNDF),A | 

DEC A. s INDICATE OUTPUT INTERRUPT EXPECTED 
LD (OIE),A ; QIE = FF HEX 

RET 


} HERRNAAKKNRNRAKRKKRRARKKCKKKAAKKR ARKH HARK RAKK 

;ROUTINE: IPORTS 

;PURPOSE: INITIALIZE 1/0 PORTS 

7;ENTRY: HL = BASE ADDRESS OF INITIALIZATION ARRAY 
sEXIT: DATA OUTPUT TO PORTS 

s;REGISTERS USED: AF,BC, HL 

} HHRRRAAKKNKAKKKKRARKKKKAKAARKKRER RAKE K 


7GET NUMBER OF DATA BYTES TO SEND TO CURRENT PORT 
sEXIT IF NUMBER OF BYTES IS 0, INDICATING TERMINATOR 


LD A, (HL) :;GET NUMBER OF BYTES 

OR A TEST FOR ZERO (TERMINATOR) 

RET Zz ;RETURN IF NUMBER OF BYTES = 0 

LD B,A 

INC HL 3;POINT TO PORT ADDRESS (NEXT BYTE) 


7C = PORT ADDRESS 
7;HL = BASE ADDRESS OF OQUTPUT DATA 


LD C, CHL) 3;GET PORT ADDRESS 

INC HL. POINT TO FIRST DATA VALUE CNEXT BYTE) 
;QUTPUT DATA AND CONTINUE TO NEXT PORT 

QTIR 7;SEND DATA VALUES TO PORT 

JR IPORTS sCONTINUE TO NEXT PORT ENTRY 


7;SIQ INITIALIZATION DATA 


SIOINT: 
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7;RESET CHANNEL A 


DB 1 
DB STOCAS 
DB 00011000B 


DB 

DB SIOCBS 

DB 00000010B 

DB SIOTV AND OFFH 
DB 00000001B 

DB 00000100B 


s INITIALIZE CHANNEL A 
DB 8 


sOUTPUT 1 BYTE 

sDESTINATION IS CHANNEL A COMMAND /STATUS 
s;SELECT WRITE REGISTER 0O 

sBITS 2,1,0 = O (WRITE REGISTER 0) 

BITS 5.4.3 = O11 CCHANNEL RESET) 

?;BITS 7,6 = 0 (DO NOT CARE) 


;SET INTERRUPT VECTOR AND ALLOW STATUS TO AFFECT IT 
4 


sQUTPUT 2 BYTES 

sDESTINATION IS COMMAND REGISTER B 
;SELECT WRITE REGISTER 2 

;SET INTERRUPT VECTOR FOR SIO 
sSELECT WRITE REGISTER 1 

sALLOW STATUS TO AFFECT VECTOR 


sQUTPUT 8 BYTES 
DESTINATION IS COMMAND REGISTER A 


:SELECT WRITE REGISTER 4 
; RESET EXTERNAL/STATUS INTERRUPT 


DB STOQCAS 

s INITIALIZE BAUD RATE CONTROL 
DB 00010100B 

DB 01001000B 


7;BIT O = O (NO PARITY) 


;BIT 1 O (DON’T CARE) 

sBITS 32.2 = 10 (1 1/72 STOP BITS) 
sBITS 5,4 = 00 (DON’T CARE) 
;BITS 7,6 = O1 (16 TIMES CLOCK) 


INITIALIZE RECEIVE CONTROL 


DB 00000011B 
DB 11000001B 


-SELECT WRITE REGISTER 3 

;BIT O = 1 CRECEIVE ENABLE) 

;BITS 4,3,2,1 = 0 (DON’T CARE) 

BIT S = 0 (NO AUTO ENABLE) 

;BIT 7,6 = 11 CRECEIVE 8 BITS/CHAR) 


7 INITIALIZE TRANSMIT CONTROL 


DE QQ0001O1B 
DB 11101010B 
DB Q000000I1B 
DB OoO01L1LO11B 


;SELECT WRITE REGISTER 5S 


>BIT O = 0 (NO CRC ON TRANSMIT) 
BIT 1 = 1 CREQUEST TQ SEND) 
7;BIT 2 = 0 (DON’T CARE) 

s;BIT 3 = 1 CTRANSMIT ENABLE) 
BIT 4 = 0 (DO NOT SEND BREAK) 


:BITS 6,5 = 11 CTRANSMIT 8 BITS/CHAR) 
;BIT 7 = 1 (DATA TERMINAL READY) 
;SELECT WRITE REGISTER 1 


sBIT O = 1 (CEXTERNAL INTERRUPTS) 
?;BIT 1 = 1 CENABLE TRANSMIT INTERRUPT) 
;BIT 2 = O (DO NOT CARE) 


s;BITS 4,3 = 11 CRECEIVE INTERRUPTS ON 
; ALL CHARS, PARITY DOES NOT AFFECT 

: VECTOR) 

BITS 7,6,5 = 000 (NO WAIT/READY 

; FUNCTION) 


402 i nerrvpts 


RECDAT: 
RECDF: 


TRNDAT : 
TRNODF : 


OIE: 


“es 


se sf “8S MO 


ESCAPE 
TESTCH 


SCLIA: 


LOOP : 


ASYNLP: 


DB 0 : TERMINATOR FOR INITIALIZATION ARRAY 
7DATA SECTION 
DS i s;RECEIVE DATA 
DS 1 ‘RECEIVE DATA FLAG 

; €O = NO DATA, FF = DATA AVAILABLE) 
DS 1 7 TRANSMIT DATA 
DS 1 : TRANSMIT DATA FLAG 

; (O =. BUFFER EMPTY. FF = BUFFER FULL) 
DS i ;OUTPUT INTERRUPT EXPECTED 


; €O = NO INTERRUPT EXPECTED, 
: FF = INTERRUPT EXPECTED) 


SAMPLE EXECUTION: 


*CHARACTER EQUATES 


EQU 
Eau 


CALL 


7 SIMPLE 
: UNTIL 


CALL 
PUSH 
CALL 
POP 
CP 
UR 


1BH ;ASCIT ESCAPE CHARACTER 
“AS 7; TEST CHARACTER = A 
INIT INITIALIZE SIO, INTERRUPT SYSTEM 


EXAMPLE - READ AND ECHO CHARACTERS 
AN ESC IS RECEIVED 


INCH ;READ CHARACTER 

AF 

OUTCH sECHO CHARACTER 

AF 

ESCAPE IS CHARACTER AN ESCAPE? 
NZ, LOOP 2STAY IN LOOP IF NOT 


7AN ASYNCHRONOUS EXAMPLE 


ws “Ee 


INPUT 


QUTPUT 


"A" TO CONSOLE CONTINUOUSLY. BUT ALSO LOOK AT 
SIDE, READING AND ECHOING ANY INPUT CHARACTERS 


;QUTPUT AN "A" IF QUTPUT IS NOT BUSY 


CALL 
JR 
LD 
CALL 


OUTST 71S QUTPUT BUSY? 

C. ASYNLP sJUMP IF IT IS 

A, TESTCH 

OQUTCH ;QUTPUT TEST CHARACTER 


sCHECK INPUT PORT 
7;ECHO CHARACTER IF ONE IS AVATLABLE 
sEXIT ON ESCAPE CHARACTER 


CALL 
JR 
CALL 
CP 
JR 


INST 71S INPUT DATA AVAILABLE? 

NC, ASYNLP ;JUMP IF NOT CSEND ANOTHER "A") 
INCH ?GET CHARACTER 

ESCAPE 71S IT AN ESCAPE? 


Z, DONE ;BRANCH IF IT IS 
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DONE: 


CALL 
JP 


JP 
END 


OUTCH 
ASYNLP 


LOOP 
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sELSE ECHO CHARACTER 
sAND CONTINUE 


Unbuffered Input/Output 


Using a PIO (PINTIO) 


Performs interrupt-driven input and output 
using a PIO and single-character input and 
output buffers. It consists of the following 
subroutines: 


1. INCH reads a character from the input 
buffer. 


2. INST determines whether the input buffer 
is empty. 


3. OUTCH writes a character into the output 
buffer. 


4. OUTST determines whether the output 
buffer is full. 


5. INIT initializes the PIO, the interrupt 
vectors, and the software flags. The flags are 
used to manage data transfers between the main 
program and the interrupt service routines. 


The actual service routines are 


1. RDHDLR responds to the input interrupt 
by reading a character from the PIO into the 
_ input buffer. 


2. WRHDLR responds tothe output interrupt 
by writing a character from the output buffer 
into the PIO. 


Procedures 


1. INCH waits for a character to become 
available, clears the Data Ready flag (RECDF), 
and loads the character into the accumulator. 


2. INST sets Carry from the Data Ready flag 
(RECDEF). 


3. OUTCH waits for the output buffer to 
empty, stores the character in the buffer, and 
sets the Character Available flag (TRNDF). If 
no output interrupt is expected (1.e., the interrupt 
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Registers Used: 
. INCH: AF 
. INST: AF 
. OUTCH: AF 
. OUTST: AF 
5. INIT: AF, BC, HL, I 
Execution Time: 
I. INCH: 72 cycles if a character is available 
2. INST: 27 cycles 


3. OUTCH: 150 cycles if the output buffer is not 
full and an output interrupt is expected; 93 additional 
cycles to send the data to the PIO if no output 
interrupt is expected. 

4. OUTST: 27 cycles 

5. INIT: 377 cycles 

6. RDHDLR: 82 cycles 

7. WRHDLR: 178 cycles 
Program Size: 166 bytes 
Data Memory Required: 5 bytes anywhere in 
RAM for the received data (address RECDAT), 
Receive Data flag (address RECDF), transmit data 
(address TRNDAT), Transmit Data flag (address 


TRNDF), and Output Interrupt Expected flag (address 
OIE) 





has been disabled because it occurred when no 
data was available), OUTCH sends the data to 
the PIO immediately. 


4. OUTST sets Carry from the Character 
Available flag (TRNDF). 


5. INIT clears the software flags, sets up the 
interrupt vectors, and initializes the PIO by 
loading its control registers and interrupt vec- 
tor. See Chapter | and Subroutine IOE for more 
details about initializing PIOs. 


6. RDHDLR reads the data, saves it in the 
input buffer, and sets the Data Ready flag 
(RECDF). | 
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7. WRHDLR determines whether data is 
available. If not, it simply disables the output 
(PIO port B) interrupt. If data is available, 
WRHDLR sends it to the PIO and clears the 
Character Available flag (TRNDF). 


The special problem here is that an output 
interrupt may occur when no data is available. 
It cannot simply be ignored or it will assert it- 
self indefinitely, causing an endless loop. The 
solution is simply to disable the output in- 
terrupt from PIO port B. 

But now a new problem arises when output 
data becomes available. That is, since the 
interrupt has been disabled, it obviously 
cannot inform the system that the output de- 
vice is ready for data. The solution is to have 
a flag that indicates (with a 0 value) that the 
output interrupt has occurred without being 
serviced. This flag is called OIE (Output In- 
terrupt Expected). 


Entry Conditions 


1. INCH: none 

2. INST: none 

3. OUTCH: character to transmit in A 
4. OUTST: none 

5. INIT: none 


Title 


we “SS “6 we we we «es 


Name: PINTIO 


Simple interrupt input and output usina a 
PIO and single character buffers 


The initialization routine clears OIE (since 
the output device surely starts out ready for 
data). The output service routine clears it when 
an output interrupt occurs that cannot be 
serviced (no data is available) and sets it after 
sending data to the PIO (in case it might have 
been cleared). Now the output routine OUTCH 
can check OIE to determine whether an output 
interrupt is expected. If not, OUTCH simply 
sends the data immediately. 

Note that a PIO interrupt cannot be cleared 
without actually sending any data. This is 
possible with an SIO (see Subroutine 11 A), so 
the procedure there is slightly different. 

Unserviceable interrupts occur only with 
output devices, since input devices always have 
data ready to transfer when they request service. 
Thus, output devices cause more initialization 
and sequencing problems in interrupt-driven 
systems than do input devices. | 


Exit Conditions 


1. INCH: character in A 


2. INST: Carry= 0if input buffer empty, 1| if 
full 


3. OUTCH: none 


4. OUTST: Carry= 01f output buffer empty, 
1 if full 


5. INIT: none 


460648 ~=648 “Se Ne 


Z30 


406 snerrvpts 


os 6s 


40 «8 48 wS YS SH WH 19 WEB ONS YS US NUE NS SS MS 48 8 NE OND NS SH NS WS WS WS C8 NS NS UNS NS NS NS SS 48 C8 6G YR NS ONS SS NS WS WS 4s ss MS NS NS NR OH Se NS 


Purposes 


Entry: 


Exits: 


Registers useds 


This program consists of 5 subroutines which 
perform interrupt driven input and output using 


a Z80 PIQ. 
INCH 

Read a character 
INST 


Determine input status (whether input 
buffer is empty) 

OUTCH 
Write a character 

OUTST 
Determine output status (whether output 
buffer is full) 

INIT 
Initialize PIO and interrupt system 


INCH 
No parameters 
INST 
No parameters 
OUTCH 
Register A = character to transmit 
OUTST 
No parameters 
INIT 
No parameters 


INCH 
Register A = character 
INST 
Carry = O if input buffer is empty. 
1 if character is available 
OUTCH 
No parameters 
OUTST 
Carry = 0 if output buffer is not 
full, 1 aif it is full 
INIT 
No parameters 


INCH 
A,F 
INST 
A,F 
QUTCH 
A,F 
QUTST 
A,F 
INIT 
A,F,BC,HL,I 


“us we 


a <8 “BB “8 4H NS wH OWE lU88 CS lee Ue US Ne 


=e we “SB WS 48 


7) er) ee) ee) ee ee es et | 


as 98 VG ~wS we we WS 


“ewe “8 4H 48 ep us we we we MS 


Cy ee ee ee) ee eT 


eotu™weO us 6NS SS SS USS UE USS 


we 46 48 WO 


PIOAD 
PIQAC 
PIOBD 
PIOBC 
INTRPV 
PIOIVA 
PIOIVB 


INCH: 


INST: 


QUTCH: 
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Times INCH 
72 cycles if a character is available 
INST 
27 cycles 
QUTCH 
150 cycles if output buffer is nat full 
and output interrupt is expected 
OUTST 
27 ecyeles 
INIT 
377 cycles 
RDHDLR 
S2 cycles 
WRHDLR 
178 cycles 


Sizes: Fragram 166 bytes 
Data 5 bytes 


7;PIO EQUATES 

PIO IS PROGRAMMED FOR: 

PORT A INPUT 

PORT B QUTPUT 

7 ARBITRARY PIQ PORT ADDRESSES 


«sa “aS ~we 


EQU 90H PORT A DATA 

EQU 91H 7;PORT A CONTROL 

EQU 92H ;PORT B DATA 

EQU 93H sPORT B CONTROL 

EQU 3000H s;BASE OF INTERRUPT VECTORS 
EQU INTRPV ; INTERRUPT VECTOR FOR PORT A 
EQU INTRPV+2 s INTERRUPT VECTOR FOR PORT B 


sREAD CHARACTER 


CALL INST 3;GET INPUT STATUS 

JR NC, INCH 7;WAIT IF NOQ CHARACTER AVAILABLE 
DI DISABLE INTERRUPTS 

SUB A 

LD (RECDF),A ; INDICATE INPUT BUFFER EMPTY 

LD A. CRECDAT) ?GET CHARACTER FROM INPUT BUFFER 
EI ;REENABLE INTERRUPTS 

RET 


7;RETURN INPUT STATUS (CARRY = 1 IF INPUT DATA IS AVAILABLE) 
LD A, (RECDF ) s;GET DATA READY FLAG 
RRA 7;SET CARRY FROM DATA READY FLAG 
; IF CARRY = 1, CHARACTER IS AVAILABLE 
RET 


;WRITE CHARACTER 


PUSH AF ?SAVE CHARACTER TO WRITE 


Py a ) er | er )  ) ee ee ee ee) ee) ee ee ee es ee 
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WAITOC: 


QUTST: 


INIT: 


RDHDLR: 


sWAIT FOR CHARACTER BUFFER TO EMPTY, THEN STORE NEXT CHARACTER 


CALL OUTST 7GET OUTPUT STATUS 

JR C,WAITOC ;WAIT IF QUTPUT BUFFER IS FULL 

DI 7;DISABLE INTERRUPTS WHILE LOOKING AT 
: SOFTWARE FLAGS 

POP AF 7GET CHARACTER 

LO (TRNDAT),A s;STORE CHARACTER IN OUTPUT BUFFER 

LOD A, OFFH ; INDICATE OUTPUT BUFFER FULL 

LD (TRNDF).A 

LD A, (OTE) TEST OUTPUT INTERRUPT EXPECTED FLAG 

OR A 

CALL Z, QUTDAT ;OUTPUT CHARACTER IMMEDIATELY IF 
7 NO OUTPUT INTERRUPT EXPECTED 

EI ;ENABLE INTERRUPTS 

RET 


sQUTPUT STATUS CCARRY = 1 IF OUTPUT BUFFER IS FULL) 


LD A, (TRNDF ) 7;GET TRANSMIT FLAG 
RRA 7SET CARRY FROM TRANSMIT FLAG 
RET ; CARRY = 1 IF QUTPUT BUFFER FULL 


2 INITIALIZE PIO AND INTERRUPT SYSTEM 


DI ;DISABLE INTERRUPTS 

s INITIALIZE SOFTWARE FLAGS 

SUB A 

LD (RECDF),A y;NO INPUT DATA AVAILABLE 

LD (TRNDF),A sQUTPUT BUFFER EMPTY 

LD (OIE),A 7;NOQ QUTPUT INTERRUPT EXPECTED 


; DEVICE IS READY INITIALLY 


s INITIALIZE INTERRUPT VECTORS 


LD A, INTRPV SHR 8 ;GET HIGH BYTE OF INTERRUPT PAGE 
LD I,A 7;SET INTERRUPT VECTOR IN Z80 
IM 2 s; INTERRUPT MODE 2 - VECTORS IN TABLE 
: ON INTERRUPT PAGE 
LD HL, RDHDLR sSTORE READ VECTOR CINPUT INTERRUPT) 
LD (PIOTVA), HL 
LD HL ,WRHDLR ?;STORE WRITE VECTOR COUTPUT INTERRUPT) 
LD (PIOIVB), HL 


sINITIALIZE PIO 


LD HL,PIOINT ;BASE ADDRESS OF INITIALIZATION ARRAY 
CALL IPORTS sINITIALIZE PIO 

EI ; ENABLE INTERRUPTS 

RET 


;INPUT CREAD) INTERRUPT HANDLER 


PUSH AF 
IN A, (PIOAD) 7;READ DATA FROM PIO 
LD (RECDAT),A s;SAVE DATA IN INPUT BUFFER 


WRHDLR =: 


NODATA: 


WRDONE = 


OUTDAT =: 
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LD A, OFFH s INDICATE INPUT DATA AVAILABLE 
LD (RECDF),A 

PoP AF 

EI sREENABLE INTERRUPTS 

RETI 


sOQUTPUT CWRITE) INTERRUPT HANDLER 


PUSH AF 

LD A, (TRNDF ) GET DATA AVAILABLE FLAG 
RRA 

JR NC,NODATA sJUMP IF NO DATA TO TRANSMIT 
CALL QUTDAT sQUTPUT DATA TO PIO 

JR WRDONE 


IF AN QUTPUT INTERRUPT OCCURS WHEN NO DATA IS AVAILABLE, 

WE MUST DISABLE IT TO AVOID AN ENDLESS LOOP. LATER, WHEN A 
CHARACTER BECOMES AVAILABLE, WE NEED TO KNOW THAT AN QUTPLIT 
INTERRUPT HAS OCCURRED WITHOUT BEING SERVICED. THE KEY HERE 
IS THE QUTPUT INTERRUPT EXPECTED FLAG OIE. THIS FLAG IS 
CLEARED WHEN AN OUTPUT INTERRUPT HAS OCCURRED BUT HAS NOT 

BEEN SERVICED. IT IS ALSO CLEARED INITIALLY SINCE THE 

OUTPUT DEVICE IS ASSUMED TO START OUT READY. OIE IS SET 
WHENEVER DATA IS ACTUALLY SENT TO THE PIO. THUS THE OUTPUT ROUTINE 
OQUTCH CAN CHECK OIE TO DETERMINE WHETHER TO SEND THE DATA 
IMMEDIATELY OR WAIT FOR AN OUTPUT INTERRUPT. 
THE PROBLEM IS THAT AN QUTPUT DEVICE MAY REQUEST SERVICE BEFORE 
THE COMPUTER HAS ANYTHING TO SEND CUNLIKE AN INPUT DEVICE 

THAT HAS DATA WHEN IT REQUESTS SERVICE). THE OIE FLAG SOLVES 
THE PROBLEM OF AN UNSERVICED OUTPUT INTERRUPT ASSERTING ITSELF 
REPEATEDLY, WHILE STILL ENSURING THE RECOGNITION OF 

QUTPUT INTERRUPTS. 
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SUB A 

LD (QIE),A s; INDICATE NO OUTPUT INTERRUPT EXPECTED 
LO A,00000011B sDISABLE OQUTPUT INTERRUPTS 

OUT (PIOBC),A 

POP AF sRESTORE REGISTERS 

EI 

RETI 


7 MRE IESE NE HC IE IE 9E BE HE OE 98 9 IE IE NE EE EE FE HE HE NE HE IG DE TE ENE HE 9E EE 3 HE 
sROUTINE: OUTDAT 

7PURPOQSE: SEND CHARACTER TQ PIO PORT B 
sENTRY: TRNDAT = CHARACTER 

zEXIT: NONE 

sREGISTERS USED: AF 

3 PERE IE IE BE DE OE NE IE BE HE FE FE 9C HE HE IE IE UE EE FE FE OE HE HE 9 9S EE E96 9 HE EE TE EE 


LD A, (TRNDAT) sGET DATA FROM OUTPUT BUFFER 
QUT (PIOBD),A ;SEND DATA TO PIO 
SUB A 2 INDICATE OUTPUT BUFFER EMPTY 
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IPORTS: 


PIOINT: 


LD (TRNDF),A 

DEC A s INDICATE OUTPUT INTERRUPT EXPECTED 
LD (OIE),A 3; OIE = FF HEX 

LD A, 10Q000011B sENABLE OUTPUT INTERRUPTS 

OUT (PIOBC).A 

RET 


| EHKKRKKRKKKRKKKKKKRRKRHKKRKAKKKHRAKKERRRR 

;ROUTINE: IPORTS 

;PURPOSE: INITIALIZE I/O PORTS 

sENTRY: HL = BASE ADDRESS OF INITIALIZATION ARRAY 
sEXIT: DATA OUTPUT TO PORTS 

;REGISTERS USED: AF,BC, HL 

$ FERRARA KKRARAKKRRKHRKRKRRKRKKRRR RAH 


3;GET NUMBER OF DATA BYTES TO SEND TO CURRENT PORT 
sEXIT IF NUMBER OF BYTES IS 0, INDICATING TERMINATOR 


LD A, CHL) ;GET NUMBER OF BYTES 

OR A s;TEST FOR ZERO (TERMINATOR) 

RET Z sRETURN IF NUMBER OF BYTES = 0 

LD B,A 

INC HL ;POINT TO PORT ADDRESS (NEXT BYTE) 


:C = PORT ADDRESS 
7;HL = BASE ADDRESS OF OUTPUT DATA 


LD C. CHL) :GET PORT ADDRESS 

ING HL s;POINT TO FIRST DATA VALUE (NEXT BYTE) 
;QUTPUT DATA AND CONTINUE TO NEXT PORT 

OTIR ;SEND DATA VALUES TO PORT 

JR IPORTS sCONTINUE TO NEXT PORT ENTRY 


sPIQ INITIALIZATION DATA 
PORT A = INPUT 
PORT B = OUTPUT 


= 638 


DB 3 sOUTPUT 3 BYTES 

DB PIOAC :DESTINATION IS PORT A CONTROL 

DB PIOIVA AND OFFH ;SET INTERRUPT VECTOR FOR PORT A 

DB 10001111B sBITS 3,2,1,0 = 1111 (MODE SELECT) 
s;BITS 35,4 = 00 (DON’T CARE > 
;BITS 7,6 = O1 CINPUT MODE) 

DB 100001 1L1B ?BITS 3.2.1.0 = O111 CINTERRUPT CONTROL) 
s;BITS 6,5,4 = 000 CDON’T CARE) 
7;BITS 7 = 1 CENABLE INTERRUPTS) 

DB 3 ;QUTPUT 3 BYTES 

DB PIOBC :DESTINATION IS PORT B CONTROL 

DB PIOIVB AND OFFH ;SET INTERRUPT VECTOR FOR PORT 56 

DB 11001111B s;BITS 3,2,1,0 = 1111 (MODE SELECT) 


sBITS 3,4 00 (DON’T CARE) 
?BITS 7,6 00 (CONTROL MODE) 
DB 00000111B ?:BITS 3.2,1,0 = O111 CINTERRUPT CONTROL) 
sBIT 4,5,6 = 000 (DON’T CARE) 
sBITS 7 = O CDISABLE INTERRUPTS) 


RECDAT: 
RECDF: 


TRNDAT: 
TRNOF : 


OIE: 


ue ows 


os ws “BS 


ESCAPE 
TESTCH 


SC1iiBs 


LOOP: 


ASYNLP: 
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DB 0 7 TERMINATOR FOR INITIALIZATION ARRAY 
DATA SECTICN 
DS i 7;RECEIVE DATA 
DS i ;RECEIVE DATA FLAG 

; (0 = NO DATA. FF = DATA) 
DS i 7 TRANSMIT DATA 
DS 1 ? TRANSMIT DATA FLAG 

(QO = BUFFER EMPTY, FF = BUFFER FULL) 

DS i OUTPUT INTERRUPT EXPECTED 


~we “@ «ws we 


(O = NO INTERRUPT EXPECTED, 
FF = INTERRUPT EXPECTED) 
SAMPLE EXECUTION: ; 
sCHARACTER EQUATES 
EQU 1BH ,ASCIT ESCAPE CHARACTER 
EQU “AS ;TEST CHARACTER = A 
CALL INIT INITIALIZE PIO, INTERRUPT SYSTEM 


7;SIMPLE EXAMPLE - READ AND ECHO CHARACTERS 
: UNTIL AN ESC IS RECEIVED 


CALL INCH 7;READ CHARACTER 

PUSH AF 

CALL QUTCH sECHO CHARACTER 

POP AF 

CP ESCAPE IS CHARACTER AN ESCAPE? 
JR NZ, LOOP 7;STAY IN LOOP IF NOT 


3AN ASYNCHRONOUS EXAMPLE 
QUTPUT "A" TO CONSOLE CONTINUOUSLY, BUT ALSO LOOK AT 
INPUT SIDE, READING AND ECHOING ANY INPUT CHARACTERS 
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7QUTPUT AN "A" IF OUTPUT IS NOT BUSY 

CALL QUTST 71S QUTPUT BUSY? 

JR C,ASYNLP sJUMP IF IT IS 

LD A, TESTCH 

CALL OQUTCH ;QUTPUT TEST CHARACTER 


s;CHECK INPUT PORT 
sECHO CHARACTER IF ONE IS AVAILABLE 
s;EXIT ON ESCAPE CHARACTER 


CALL. INST ;IS INPUT DATA AVAILABLE? 
JR NC, ASYNLP ;JUMP IF NOT (SEND ANOTHER "A") 
CALL INCH 7GET THE CHARACTER 


CP ESCAPE 71S IT AN ESCAPE CHARACTER? 
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ASDONE : 


JR 
CALL 
JP 
JP 


END 


Z. ASDONE 
OUTCH 
ASYNLP 


LOOP 


sJUMP IF IT IS 
7;ELSE ECHO CHARACTER 
sAND CONTINUE 


Buffered Input/Output 
Using an SIO (SIN/B) 


Performs interrupt-driven input and output 
using an SIO and multiple-character buffers. 
Consists of the following subroutines: 


1. INCH reads a character from the input 
buffer. 


2. INST determines whether the input buffer 
is empty. 


3. OUTCH writes a character into the output 
buffer. 


4. OUTST determines whether the output 
buffer is full. 


5. INIT initializes the buffers, the interrupt 
system, and the SIO. 


The actual service routines are 


1. RDHDLR responds to the input interrupt 
by reading a character from the SIO into the 
input buffer. 


2. WRHDLR responds to the output interrupt 
by writing a character from the output buffer 
into the SIO. 


Procedures 


1. INCH waits for a character to become 
available, gets the character from the head of 
the input buffer, moves the head up one position, 
and decreases the input buffer counter by I. 


2. INST clears Carry if the input buffer 
counter is 0 and sets it otherwise. 


3. OUTCH waits until there is space in the 
output buffer (that is, until the output buffer is 
not full), stores the character at the tail of the 
buffer, moves the tail up one position, and in- 
creases the output buffer counter by 1. 


ee 


Registers Used: 
. INCH: AF, C, DE, HL 
. INST: AF 
. OUTCH: AF, DE, HL 
. OUTST: AF 
. INIT: AF, BC, HL, I 
Execution Time: 
1. INCH: 197 cycles if a character is available 
2. INST: 39 cycles 


3. OUTCH: 240 cycles if the output buffer is not 
full and an output interrupt is expected; 160 addition- 
al cycles to send the data to the SIO if no output 


interrupt is expected. 

4. OUTST: 34 cycles 

5. INIT: 732 cycles 

6. RDHDLR: 249 cycles 

7. WRHDLR: 308 cycles 
Program Size: 299 bytes 
Data Memory Required: [1 bytes anywhere in 
RAM for the heads and tails of the input and output 
buffers (2 bytes starting at addresses IHEAD, ITAIL, 
OHEAD, and OTAIL, respectively), the numbers of 
characters in the buffers (2 bytes at addresses ICNT 
and OCNT), and the Output Interrupt Expected flag 


(address OIE). This does not include the actual input 
and output buffers. 





4. OUTST sets Carry if the output buffer 
counter is equal to the buffer’s length (i.e., if 
the output buffer is full) and clears Carry other- 
wise. 


5. INIT clears the buffer counters, sets both 
the heads and the tails of the buffers to their 
base addresses, sets up the interrupt vectors, 
and initializes the SIO by storing the appropriate 
values in its control registers. See Subroutine 
10E for more details about initializing SIOs. 
INIT also clears the Output Interrupt Expected 
flag, indicating that the SIO is initially ready to 
transmit data. 
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6. RDHDLR reads a character from the 
SIO. If there is room in the input buffer, it stores 
the character at the tail of the buffer, moves 
the tail up one position, and increases the in- 
put buffer counter by 1. If the buffer is full, 
RDHDLR simply discards the character. 


7. WRHDLR determines whether output 
data is available. If not, it simply resets the 
output interrupt. If data is available, WRHDLR 
obtains a character from the head of the output 
buffer, moves the head up one position, and 
decreases the output buffer counter by |. 


The new problem with multiple-character 
buffers is the management of queues. The main 
program must read the data in the order in 
which the input interrupt service routine receives 
it. Similarly, the output interrupt service routine 
must send the data in the order in which the 
main program stores it. Thus, there are the 
following requirements for handling input: 


1. The main program must know whether 
the input buffer is empty. 


2. If the input buffer is not empty, the main 
program must know where the oldest character 
is (that is, the one that was received first). 


3. The input interrupt service routine must 
know whether the input buffer is full. 


4. Ifthe input buffer is not full, the interrupt 
service routine must know where the next 
empty place is (that is, where it should store the 
new character). 


The output interrupt service routine and the 
main program have similar requirements for 
the output buffer, although the roles of sender 
and receiver are reversed. 

Requirements | and 3 are met by maintaining 
acounter ICNT. INIT initializes ICNT to 0, the 
interrupt service routine adds | to it whenever it 


receives a character (assuming the buffer is not 
full), and the main program subtracts | from it 
whenever it removes a character from the 
buffer. Thus, the main program can determine 
whether the input buffer is empty by checking if 
ICNT is 0. Similarly, the interrupt service rou- 
tine can determine whether the input buffer is 
full by checking if ICNT is equal to the size of 
the buffer. 

Requirements 2 and 4 are met by maintain- 
ing two pointers, IHEAD and ITAIL, defined 
as follows: 


1. ITAIL contains the address of the next 
empty location in the input buffer. 


2. IHEAD contains the address of the oldest 
character in the input buffer. 


INIT initializes IHEAD and ITAIL to the 
base address of the input buffer. Whenever the 
interrupt service routine receives a character, it 
places it in the buffer at ITAIL and moves ITAIL 
up one position (assuming that the buffer is not 
full). Whenever the main program reads a 
character, it removes it from the buffer at 
IHEAD and moves IHEAD up one position. 
Thus, IHEAD “chases” ITAIL across the buffer 
with the service routine entering characters at 
one end (the tail) while the main program 
removes them from the other end (the head). 

The occupied part of the buffer could thus 
start and end anywhere. If either IHEAD or 
ITAIL goes beyond the end of the buffer, the 
program simply sets it back to the buffer’s base 
address, thus providing wraparound. That is, 
the occupied part of the buffer could start near 
the end (say, at byte #195 of a 200-byte buffer) 
and continue back past the beginning (say, to 
byte #10). Then IHEAD would be BASE+ 194, 
ITAIL would be BASE+9, and the buffer 
would contain 15 characters occupying ad- 
dresses BASE+194 through BASE+199 and 
BASE through BASE+8. 
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multiple-character buffers 


Entry Conditions Exit Conditions 
1. INCH: none 1. INCH: character in A 
2. INST: none 2. INST: Carry= 0 if input buffer empty, 1 if 
3. OUTCH: character to transmit in A otherwise 
4. OUTST: none 3. OUTCH: none 
5 INIT none 4. OUTST: Carry = 0 if output buffer not 
full, 1 if full 
5. INIT: none 
é : 
; Title Interrupt input and output using a Z80 SIO and ; 


Names: SINTB ; 
Purposes This program consists of 5 subroutines which ; 
perform interrupt driven input and output using ; 

a Z80O SIG. : 

INCH ; 

Read a character ; 

INST : 


Determine input status (whether input 
buffer is empty) 

OUTCH 
Write a character 

OUTST 
Determine output status (whether output 
buffer is full) 

INIT 
Initialize SIQ and interrupt system 


Entry: INCH 
No parameters 
INST 
No parameters 
QUTCH 
Register A = character to transmit 
OUTST 
No parameters 
INIT 
No parameters 
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STOCAD 


Exits 


Reqisters used: 


Times 


6 


SIQ EQUATES 
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INCH 
Register A = character 
INST 
Carry = O if input buffer is empty, 
1 if character is available 
QUTCH 
No parameters 
OUTST 
Carry = O if output buffer is not 
full. i if it is full 
INIT 
Na parameters 


INCH 
AF,C, DE, HL 
INST 
AF 
QUTCH 
AF, DE, HL 
OUTST 
AF 
INIT 
AF, BC,HL, I 


INCH 
Approximately 197 cycles if a character is 
available 
INST 
3Y cycles 
QUTCH 
Approximately 240 cycles if output buffer 
is not full and output interrupt is expected 
QUTST 
34 cycles 
INIT 
732 cycles 
RDHDBLR 
Approximately 249 cycles 
WRHDLR 
Approximately 308 cycles 


Program 299 bytes 
Nata 1i bytes plus size of buffers 


SIO IS PROGRAMMED FOR: 
ASYNCHRONOUS OPERATION 
i6 X BAUD RATE 
8-BIT CHARACTERS 
1 1/2 STOP BITS 


sARBITRARY SIO PORT ADDRESSES 


EQU iCH 


3SIQ CHANNEL A DATA 


ee «8 “a “WS “ES “WES WS 48 648 658 eS OM 


—8 <8 «9 «8 ya “# MS US 6H 48 48 NS WS NE SR SK SE OSE Og 4s ee ws Me ue VS MS 


=e “ws “8S $6 = «68 WSR SH OTE 


STOCBD 
STIOCAS 
STOCBS 
SIOIV 
SIOWV 
SIOEV 


STORV 
STOSV 


INCH: 


INST: 


QUTCH: 


WAITOC: 


EQU 
EQU 
EQU 
EQuU 
EQU 
EQU 


EQU 
EQU 


1EH 

iDH 

1FH 
S000H 
SIOIV+8 
STOIV+10 


STOIV+12 
STOIV+14 


sREAD CHARACTER 


CALL. 
JR 
DI 
LD 
DEC 
LD 
LD 
CALL 
LD 
LD 
ET 
RET 


sRETURN 


LD 
QR 
RET 
SCF 
RET 


INST 
NC, INCH 


HL, ICNT 
CHL) 

HL, (THEAD) 
C, CHL) 
INCIPTR 
(ITHEAD), HL 
A.C 
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SIO CHANNEL B DATA 

3SIQ CHANNEL A COMMANDS/STATUS 

SIO CHANNEL B COMMANDS/STATUS 

s INTERRUPT VECTOR 

:STQ CHANNEL A WRITE INTERRUPT VECTOR 
>SIO CHANNEL A EXTERNAL/STATUS 

; INTERRUPT VECTOR 

SIO CHANNEL A READ INTERRUPT VECTOR 
STO CHANNEL A SPECIAL RECEIVE 

; INTERRUPT VECTOR 


GET INPUT STATUS 

s;WAIT IF NO CHARACTER AVAILABLE 

DISABLE INTERRUPTS 

sREDUCE INPUT BUFFER COUNT BY 1 

GET CHARACTER FROM HEAD OF INPUT BUFFER 


3;MOVE HEAD POINTER UP 1 


;REENABLE INTERRUPTS 


INPUT STATUS CCARRY = 1 IF INPUT DATA IS AVAILABLE) 


A, CICNT) 
A 
Zz 


s;WRITE CHARACTER 


PUSH 


7;WAIT FOR OUTPUT BUFFER 


CALL 
JR 
DI 


AF 


QUTST 
C,WAITOC 


HL. OCNT 
CHL) 

HL, (OTAIL) 
AF 

CHLD,A 
INCOPTR 
COTAIL). HL 
A, (OIE) 

A 

Z,QUTDAT 


TEST INPUT BUFFER COUNT 

:CLEAR CARRY ALWAYS 

sRETURN, CARRY = 0 IF NO DATA 

7;SET CARRY 

;RETURN, CARRY = 1 IF DATA AVAILABLE 


;SAVE CHARACTER TO OUTPUT 


NOT FULL, THEN STORE NEXT CHARACTER 


GET QUTPUT STATUS 

sWAIT IF OUTPUT BUFFER IS FULL 
s;DISABLE INTERRUPTS WHILE LOOKING AT 
; BUFFER, INTERRUPT STATUS 

s INCREASE OUTPUT BUFFER COUNT BY 1 


;PQINT TO NEXT EMPTY BYTE IN BUFFER 
GET CHARACTER 

STORE CHARACTER AT TAIL OF BUFFER 
7>MQVE TAIL POINTER UP 1 


;TEST QUTPUT INTERRUPT EXPECTED FLAG 


;QUTPUT CHARACTER IMMEDIATELY IF 
; OUTPUT INTERRUPT NOT EXPECTED 
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OUTST: 


INIT: 


RDHDLR = 


RO1is 


EI 
RET 


;QUTPUT STATUS (CARRY = 


LD 
CP 
CCF 
RET 


sINITIALIZE SIO, 


A, COCNT) 
SZOBUF 


;REENABLE INTERRUPTS 


1 IF BUFFER IS FULL) 


3;GET CURRENT QUTPUT BUFFER COUNT 
sCOMPARE TO MAXIMLIM 

7;COMPLEMENT CARRY 

7;CARRY = 1 IF BUFFER FULL, O IF NOT 


INTERRUPT SYSTEM 


sDISABLE INTERRUPTS 


s;INITIALIZE BUFFER COUNTERS AND POINTERS, INTERRUPT FLAG 


s INDICATE NO OUTPUT INTERRUPTS 
7;BUFFER COUNTERS = 0 


s;ALL BUFFER POINTERS = BASE ADDRESS 


s;GET HIGH BYTE OF INTERRUPT PAGE 
;SET INTERRUPT VECTOR IN Z80 

s; INTERRUPT MODE 2 ~- VECTORS IN TABLE 
: ON INTERRUPT PAGE 

;STORE READ VECTOR 


;STORE WRITE VECTOR 

;STORE EXTERNAL/STATUS VECTOR 

:STORE SPECIAL RECEIVE VECTOR 

;BASE ADDRESS OF INITIALIZATION ARRAY 


s INITIALIZE SIO 
; ENABLE INTERRUPTS 


DI 

SUB A 

LD (OIE),A 

LO CICNT),A 

LD COCNT).A 

LD HL, I BUF 

LD CTHEAD), HL 
LD CITAIL), HL 
LD HL. OBUF 

LD (OHEAD) , HL 
LD (OTAIL), AL 
sINITIALIZE INTERRUPT VECTORS 
LOD A,SIOIV SHR 8 
LD I,A 

IM 2 

LD HL. RDHDLR 

LD (STORV), HL 

LD HL. WRHDLR 

LD (STOWV), HL 

LD HL, EXHDLR 

LD (SIOEV),HL 

LD HL, REHDLR 

LD (STOSV).HL 
INITIALIZE 1/0 PORTS 
LD HL, SIOINT 
CALL IPORTS 

EI 

RET 


INPUT CREAD) INTERRUPT 


PUSH 
PUSH 
PUSH 
PUSH 


IN 
LD 
LOD 


A, (SIOCAD) 
C,A 
HL, ICNT 


HANDLER 


7;SAVE REGISTERS 


7;READ DATA FROM SIO 
sSAVE DATA IN REGISTER C 


sANY ROOM IN INPUT BUFFER? 


XITRH: 


WRHDLR = 


NODATA: 


WRDONE = 


EXHDLR: 
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LD A, CHL) 

cP SZIBUF 

JR NC. XITRH ‘JUMP IF NO ROOM 

INC CHL) s INCREMENT INPUT BUFFER COUNTER 
LD HL, CITAIL) ;STORE CHARACTER AT TAIL OF INPUT BUFFER 
LO CHL),C 

CALL INCIPTR ; INCREMENT TAIL POINTER 

LD CITAIL), HL 

POP HL sRESTORE REGISTERS 

POP DE 

POP BC 

POP AF 

EI ;REENABLE INTERRUPTS 

RET I 


s;QUTPUT CWRITE) INTERRUPT HANDLER 


PUSH AF ;SAVE REGISTERS 

PUSH BC 

PUSH DE 

PUSH HL 

LO A, COCNT) 7GET OUTPUT BUFFER COUNTER 
OR A TEST FOR EMPTY BUFFER 

JR Z,NODATA 7;JUMP IF NO DATA TO TRANSMIT 
CALL OUTDAT sELSE OUTPUT DATA 

JR WRDONE 


;IF AN QUTPUT INTERRUPT OCCURS WHEN NOG DATA IS AVAILABLE. 

WE MUST DISABLE OUTPUT INTERRUPTS TQ AVOID AN ENDLESS LOOP. 
WHEN THE NEXT CHARACTER IS READY, IT MUST BE SENT IMMEDIATELY 
SINCE NO INTERRUPT WILL OCCUR. THIS STATE IN WHICH AN QUTPUT 
INTERRUPT HAS OCCURRED BUT HAS NOT BEEN SERVICED IS INDICATED 
BY CLEARING OIE (COQUTPUT INTERRUPT EXPECTED FLAG). 


<8 “6 46 WE “a 


SUB A 

LD (OTE),A 7;D0 NOT EXPECT AN INTERRUPT 
OUT (STIQCAS).A SELECT REGISTER O 

LD A,00101000B sRESET TRANSMITTER INTERRUPT 
OUT (STOCAS),A 

POP HL sRESTORE REGISTERS 

POP DE 

POP BC 

POP AF 

ET 

RET I 


;EXTERNAL/STATUS CHANGED INTERRUPT HANDLER 


PUSH AF 
LD A,00010000B s;RESET STATUS INTERRUPT 
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OUT (SIOCAS).A 

POP AF 

EI :DCD OR CTS LINE CHANGED STATE. OR A 
RETI ; BREAK WAS DETECTED 


;SERVICE HERE IF NECESSARY 


;SPECIAL RECEIVE ERROR INTERRUPT 


REHDLR: 
PUSH AF 
LD A,00110000B :RESET RECEIVE ERROR INTERRUPT 
OUT CSIOCAS).A 
POP AF 
EI FRAMING ERROR OR OVERRUN ERROR OCCURRED 
RETI ¢ SERVICE HERE IF NECESSARY 


¢ ENEKRKRAAKKRRAKKRRRARKKRRRRRARKKKRKR RRA 
;ROUTINE: OUTDAT 

;PURPOSE: SEND CHARACTER TO SIQ 

s;ENTRY: NONE 

sEXIT: NONE 

sREGISTERS USED: AF,DE,HL 

} RHHMHACAKKKKRAHKAKKKKKKKRKKKRRRKKK KKK TH 


QUTDAT: 
LD HL, (OHEAD) 
LD A, CHL) ;GET DATA FROM HEAD OF OUTPUT BUFFER 
OUT (SIOCAD).A sQUTPUT DATA 
CALL INCOPTR > INCREMENT HEAD POINTER 
LO (OQHEAD), HL 
LD HL, OCNT sDECREMENT OUTPUT BUFFER COUNT 
DEC CHL) 
LD A, OFFH 
LD (QIE),A s;EXPECT AN QUTPUT INTERRUPT 
RET 


} HRRRKRKKKKRKRRKRRKRRRRRKRKKKKKRERRRRHKH 

sROUTINE: INCIPTR 

;PURPOSE: INCREMENT POINTER INTO INPUT 

; BUFFER WITH WRAFARQUND 

7;ENTRY: HL = POINTER 

sEXIT: HL = POINTER INCREMENTED WITH WRAPARQUND 
7REGISTERS USED: AF, DE, HL 

¢ HHRRRARRKRRRRRRRRKRKRRRREREKRRRRRRRHRR AR 


INCIPTR: 
INC HL. 7 INCREMENT POINTER 
LD DE, EI BUF 7COMPARE POINTER, END OF BUFFER 
LD AL 
CP Ee 
RET NZ 
LD A,H 
cP DB 
RET NZ sRETURN IF NOT EQUAL 
LD HL, IBUF ;IF POINTER AT END OF BUFFER, 


RET ; SET IT BACK TO BASE ADDRESS 


INCOPTR: 


IPORTS: 


SIOINT: 
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sROUTINE: INCOPTR 

;PURPOSE: INCREMENT POINTER INTO OUTPUT 

; BUFFER WITH WRAPAROUND 

sENTRY: HL = POINTER 

sEXIT: HL = POINTER INCREMENTED WITH WRAPAROUND 
7;REGISTERS USED: AF, DE, HL 

{ RERRRARRRRRARRAEKRRRKTRRKRRKRRKKRERKRRRHRKH 


INC HL > INCREMENT POINTER 

LD DE, EQRUF ;COMPARE POINTER, END QF BUFFER 
LO é.L 

CP E 

RET NZ 

LD AH 

CP D 

RET NZ 

LD HL., OBUF ;IF POINTER AT END OF BUFFER, 
RET ; SET IT BACK TO BASE ADDRESS 


F MMMM RRA ARMA MI MMIII HH HH 
sROUTINE: IPORTS 

;PURPOSE: INITIALIZE 1/0 PORTS 

sENTRY: HL = BASE ADDRESS OF INITIALIZATION ARRAY 
s;EXIT: DATA OUTPUT TO PORTS 

sREGISTERS USED: AF.BC.HL 

2 RXKKKCKKRKRRHACKLARAKKKKKKKKKKKRRRRRRAKK 


;GET NUMBER OF DATA BYTES TO SEND TO CURRENT PORT 
s;EXIT IF NUMBER OF BYTES IS 0. INDICATING TERMINATOR 


LD A, CHL) >;GET NUMBER OF BYTES 

OR A ;TEST FOR ZERO (TERMINATOR) 

RET Zz . sRETURN IF NUMBER OF BYTES = 0 

LD B,A 

INC HL. POINT TO PORT ADDRESS CNEXT BYTE) 


7C = PORT ADDRESS 
sHL = BASE ADDRESS OF QUTPUT DATA 


LD C, CHL) 7;GET PORT ADDRESS 

INC HL 7;PQINT TO FIRST DATA VALUE (NEXT BYTE) 
sOUTPUT DATA AND CONTINUE TO NEXT PORT 

OTIR 7SEND DATA VALUES TO PORT 

JR IPORTS sCONTINUE TO NEXT PORT ENTRY 


3;SIQ INITIALIZATION DATA 


7;RESET CHANNEL A 


DB i sOUTPUT 1 BYTE 
DB STaCAS 7TOQ CHANNEL A COMMAND/STATUS 
DE 00011000B sSELECT WRITE REGISTER O 


BITS 2,1,0 = O CWRITE REGISTER 0) 
;BITS 35,4,3 = O11 CCHANNEL RESET) 
BITS 7,6 = 0 (DQ NOT CARE) 
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IHEAD: 
ITAIL: 


ICNTs 
OHEAD: 


;SET INTERRUPT VECTOR AND ALLOW STATUS TO AFFECT IT 


DR 4 s;QUTPUT 2 BYTES 

DB SsToces 7DESTINATION IS COMMAND REGISTER B 
DB 0000001 0B ;SELECT WRITE REGISTER 2 

DB SIOIV AND OFFH ;SET INTERRUPT VECTOR FOR SIO 

DB Q0000001B sSELECT WRITE REGISTER 1 

DB 00000100B ; TURN ON STATUS AFFECTS VECTOR 

7 INITIALIZE CHANNEL A 

DB 3 :OUTPUT 8 BYTES 

DB STOCAS s;DESTINATION IS COMMAND REGISTER A 


s INITIALIZE BAUD RATE CONTROL 
DB 00010100B ;SELECT WRITE REGISTER 4 
; RESET EXTERNAL/STATUS INTERRUPT 
DB 01001000B ‘BIT 0 QO (NO PARITY) 
sBIT 1 O (DON’T CARE) 
sBITS 3,2 10 (1 1/2 STOP BITS) 
;BITS 5.4 00 (DON’T CARE) 
sBITS 7,6 O1 (16 TIMES CLOCK) 


s INITIALIZE RECEIVE CONTROL 
DB o000001 1B :SELECT WRITE REGISTER 3 
DB 11000001B sBIT 0 = 1 CRECEIVE ENABLE) 
;BITS 4,3,2,1 = 0 (DON’T CARE) 
sBIT 5 = 0 (NO AUTO ENABLE) 
sBIT 7,6 = 11 CRECEIVE 8 BITS/CHAR) 


sINITIALIZE TRANSMIT CONTROL 


DB QOO000101B ‘SELECT WRITE REGISTER 53 

DB 11101010B s;BIT O = O CNO CRC ON TRANSMIT) 
BIT 1 = 1 CREQUEST TO SEND) 
sBIT 2 = 0 CDON“T CARE) 
s;BIT 3 = 1 CTRANSMIT ENABLE) 
s;BIT 4 = 0 (DO NOT SEND BREAK) 


sBITS 6,5 = 11 (TRANSMIT & BITS/CHAR) 


sBIT 7 = 1 (DATA TERMINAL READY) 
DB 00000001B ;SELECT WRITE REGISTER 1 
DB O00011011B sBIT O 1 (EXTERNAL INTERRUPTS > 


;BIT 1 = 1 CENABLE TRANSMIT INTERRUPT) 
s;BIT 2 = 0 (DO NOT CARE) 

:BITS 4.23 = 11 CRECEIVE INTERRUPTS ON 
ALL CHARS, PARITY DOES NOT AFFECT 


; VECTOR) 
*sBITS 7.6.5 = 000 (NO WAIT/READY 
3 FUNCTION) 
DB Q s;END OF TABLE 
>DATA SECTION 
DS 2 ;ADDRESS OF OLDEST CHARACTER IN INPUT 
: BUFFER 
DS 2 sADDRESS QF NEWEST CHARACTER IN INPUT 
; BUFFER 
DS i s;NUMBER OF CHARACTERS IN INPUT BUFFER 
DS 2 sADDRESS OF OLDEST CHARACTER IN OUTPLT 


; BUFFER 


OTAILs: 


QCNT: 
OIE: 


SZIBUF 
IBUF: 
EIBUF 
SZOBUF 
QBUF : 
EQBUF 
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ESCAPE 
TESTCH 


SCLICs 


LOOP: 


ASYNLP: 


DS 


DS 
DS 


EQU 
DS 
EQU 
EQU 
DS 
EQU 


SAMPLE EXECUTION: 


1 
SZIBUF 
$ 

295 
SZOBUF 
$ 
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sADDRESS OF NEWEST CHARACTER IN QUTPUT 
; BUFFER 

;NUMBER OF CHARACTERS IN OUTPUT BUFFER 
sQUTPUT INTERRUPT EXPECTED 

(O = NO INTERRUPT EXPECTED, 

FF = INTERRUPT EXPECTED) 

3;SIZE OF INPUT BUFFER 

s INPUT BUFFER 

sEND OF INPUT BUFFER 

3;SIZE OF OUTPUT BUFFER 

s;OQUTPUT BUFFER 

s;END OF OUTPUT BUFFER 


<—e8 “8 
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sCHARACTER EQUATES 


EQU 1BH s;ASCII ESCAPE CHARACTER 

EQU “A” 7 TEST CHARACTER = A 

CALL INIT sINITIALIZE SIO, INTERRUPT SYSTEM 
sSIMPLE EXAMPLE - READ AND ECHO CHARACTER 

; UNTIL AN ESC IS RECEIVED 

CALL INCH 7;READ CHARACTER 

PUSH AF 

CALL QUTCH 7;ECHO CHARACTER 

POP AF 

CP ESCAPE :IS CHARACTER AN ESCAPE? 

JR NZ, LOOP STAY IN LOOP IF NOT 

7AN ASYNCHRONOUS EXAMPLE 

: OUTPUT "A" TQ CONSOLE CONTINUOQUSLY BUT ALSO LOOK AT 
; INPUT SIDE, READING AND ECHOING ANY INPUT CHARACTERS 
sQUTPUT AN "A" IF QUTPUT IS NOT BUSY 

CALL OUTST IS OUTPUT BUSY’? 

JR C,ASYNLP ;JUMP IF IT IS 

LD A. TESTCH 

CALL QUTCH ;QUTPUT CHARACTER 


sCHECK INPUT PORT 
;ECHO CHARACTER IF ONE IS AVAILABLE 
sEXIT ON ESCAPE CHARACTER 


CALL 
JR 
CALL 
CP 
JR 


INST 
NC, ASY 
INCH 
ESCAPE 
Z, DONE 


IS INPUT DATA AVAILABLE? 
;JUMP IF NOT (SEND ANOTHER “A") 
:GET CHARACTER 

71S IT AN ESCAPE CHARACTER? 
:BRANCH IF IT IS 


NLP 
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CALL OUTCH 
JP ASYNLP 


DONE s 
JP LOOP 


END 


s;ELSE ECHO CHARACTER 
s;AND CONTINUE 


Real-Time Clock and Calendar (CLOC\) 


Maintains a time-of-day 24-hour clock and 
a calendar based on a real-time clock interrupt 
generated from a Z80 CTC. Consists of the 
following subroutines: 


1. CLOCK returns the base address of the 
clock variables. 


2. ICLK initializes the clock interrupt and 
the clock variables. 


3. CLKINT updates the clock after each 
interrupt (assumed to be spaced one tick apart). 


Procedures 


1. CLOCK loads the base address of the 
clock variables into register pair HL. The clock 
variables are stored in the following order 
(lowest address first): ticks, seconds, minutes, 
hours, days, months, less significant byte of 
year, more significant byte of year. 


2. ICLK initializes the CTC, the interrupt 
system, and the clock variables. The arbitrary 
starting time is 00:00:00, January 1, 1980. A real 
application would clearly require some kind of 
outside intervention to load or change the 
clock. 


3. CLKINT decrements the remaining tick 
count by | and updates the rest of the clock if 
necessary. Of course, the number of seconds 
and minutes must be less than 60 and the 


Eniry Conditions 


1. CLOCK: none 
2. ICLK: none 
3. CLKINT: none 


11D 


Registers Used: 
1. CLOCK: HL 
2. ICLK: AF,HL,I 
3. CLKINT: None 
Execution Time: 
1. CLOCK: 20 cycles 


2. ICLK: 251 cycles 


3. CLKINT: 93 cycles if only TICK must be dec- 
remented; 498 cycles maximum if changing to a new 
year. 

Program Size: 171 bytes 
Data Memory Required: 8 bytes for the clock vari- 
ables starting at address CLK VAR 





number of hours must be less than 24. The day 
of the month must be less than or equal to the 
last day for the current month; an array of the 
last days of each month begins at address 
LASTDY. If the month is February (#2), the 
program checks if the current year is a leap year. 
This involves determining whether the two least 
significant bits of memory location YEAR are 
both Os. If the current year is a leap year, the last 
day of February is the 29th, not the 28th. The 
month number may not exceed 12 (December) 
or a carry to the year number is necessary. The 
program must reinitialize the variables properly 
when carries occur; that is, TICK to DTICK; sec- 
onds, minutes, and hours to 0; day and month 
to 1 (meaning the first day and January, respec- 
tively). 


Exit Conditions 
1. CLOCK: base address of clock variables in 
HL 
2. ICLK: none 
3. CLKINT: none 


425 
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Examples 
These examples assume that the tick rate is Result: 
: March 8, 1982, 12:00.00 a.m. and DTICK ticks 
DTICK Hz (less than 256 Hz — typical values (TICK) = DTICK (SEC)=0 (DAY) = 08 
would be 60 Hz or 100 Hz) and that the clock (MIN)=0 (MONTH)=03 
and calendar are saved in memory locations: (HOUR)=0 (YEAR) = 1982 
TICK ticks before a carry, counted down 
from DTICK 2. Data: 
SEC seconds (0 to 59) Dec. 31, 1982, 11:59.59 p.m. and I tick left 
MIN wainutes (011059) (TICK) =1 (SEC) =59 (DAY) = 31 
HOUR hour of day (0 to 23) bee ae eons H) i 
DAY day of month (1 to 28, 29, 30, or 31) ( yee: ve = 
MONTH month of year (1 through 12) 
en ce current year Result: 
Jan. 1, 1983, 12:00.00 A.M./and DTICK ticks 
(TICK) = DTICK (SEC)=0 (DAY)=1 
1. Data: (MIN)=0 (MONTH)= 1 
March 7, 1982, 11:59.59 p.m. and | tick left (HOUR) =) COBAR) =I 


(TICK)=1 (SEC) =59 (DAY) = 07 
(MIN)=59 | (MONTH) = 03 
(HOUR) = 23 (YEAR) = 1982 


/ 
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Title Real-time clock and calendar 
Names: CLOCK 
Purposes This program maintains a time-of-day 24-hour 


clock and a calendar based on a real-time clock 
interrupt fram a Z80O CTC. 


CLOCK 

Returns base address of clock variables 
ICLK 

Initializes CTC and clock interrupt 
CLKINT 

Updates clock variables for each tick 


Ot ee) ee ee |) 


ws. « ws we 48 «48 48 WO 


Entrys CLOCK 
None 

ICLK 
None 


we we “we s8 WE WEA SWE WE <8 SS US 
ee 668 wo we WS 28 48 SS WS SE 


Exits clock 
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Register HL = Base address of time variables 
ICLkK 
None 


Registers used: CLOCK 
HL. 
ICLK 
AF,HL, I 
CLEINT 
None 


“we 6 ¢8 6 6«8 WR WA WS 688 lO lS UNE UE 


Times CLOCK 
20 cycles 
ICLK 
251 cycles 
CLKINT 
93 cycles normally if decrementing tick 
4983 cycles maximum if changing to a new year 


7 @8 WA 


Sizes: Program 171 bytes 
Data 8 bytes 


a8 “S@ 48 “WG @S 8 WS WH VSB WH 68 4H VS OWE UMS hls lB UNO lu hl lS OS 
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sARBITRARY PORT ADDRESSES FOR Z80 CTC 


CTCCHO EQU 80H s;CTC CHANNEL © PORT 

CTCITRP EQU OS000H 3;CTC INTERRUPT ADDRESS 

CTCCMD EQU 10100111B BIT 7 = 1 INTERRUPTS ENABLED 
;BIT 6 = O TIMER MODE 
;BIT 5S = 1 256 COUNT PRESCALER 
BIT 4 = O NEGATIVE EDGE TRIGGER 
;BIT 3 = O START TIMER AFTER TIME CONST 
s;BIT 2 = 1 TIME CONSTANT FOLLOWS 
*BIT 1 = 1 RESET CHANNEL 
7;BIT O = 1 CONTROL WORD 

Crcre EQU 250 7 TIME CONSTANT 


sCALCULATION FOR TICK 

ASSUME A 4 MHZ CLOCK FOR CTC WITH PRESCALER = 256 
AND COUNT = 250 = (4 ® 10*6) / (256 ® 250) 
IS ABOUT 62 TICKS PER SECOND 


we <8 ~“wSs 


DFLTS: 
DTICK EQU 62 7;DEFAULT TICK 


sRETURN BASE ADDRESS OF CLOCK VARIABLES 

CLOCK s 
LD HL, CLKVAR :GET BASE ADDRESS OF CLOCK VARIABLES 
RET 


sINITIALIZE CTC CHANNEL O AS A REAL-TIME CLOCK INTERRUPT 
ICLKs 


pI sDISABLE INTERRUPTS 

Lo A,CTCITRP SHR 8 

LO I,A sSET UP INTERRUPT VECTOR 

IM 2 sSET INTERRUPT MQDE 2 — VECTORS IN 


; TABLE ON INTERRUPT PAGE 
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CLEINT: 


LD HL, CLK INT 

LD (CTCITRP), HL 3;SET INTERRUPT ADDRESS 

LD A.1 

OUT (CTCCHO),A ;DISABLE CHANNEL O 

LD A.-CTCITRP AND OFFH sLOW BYTE OF CTC INTERRUPT 
OUT (CTCCHO),A VECTOR TO CTC 

LD A.CTCCMD 

QUT (CTCCHO),A sOUTPUT CTC COMMAND 

LD A.CTCTC 

QUT (CTCCHO),A sQUTPUT TIME CONSTANT 


FINITIALIZE CLOCK VARIABLES TO ARBITRARY VALUE 
sJANUARY 1. 1980 00:00.00 
7A REAL CLOCK WOULD NEED OUTSIDE INTERVENTION 


: TQ SET OR CHANGE VALUES 


LD HL, TICK 
LD CHL). DTICK 
INC HL. 

SUB A 

LD CHL),A 

INC HL. 

LD CHL).A 

INC HL. 

LD (HLD.A 

INC A 

INC HL. 

LD CHLD,A 

INC HL 

LD CHLI,A 

LO HL. 1980 
LD (YEAR), HL 
EI 

RET 

sHANDLE CLOCK INTERRUPT 
PUSH AF 

PUSH HL 

LD HL, TICK 
DEC CHL) 

JR NZ,EXIT1 
Lo (HL), OTICK 
PUSH BC 

PUSH DE 

LD B,0 

: INCREMENT SECONDS 
INC HL 

INC CHL) 

LD A, CHL) 

CP 60 

IR C,EXITO 


s INITIALIZE TICKS 


»SECOND = 0 
sMINUTE = 0 
sHOLIR = 0 
sA = 1 


s>DAY = 1 (FIRST) 
sMOQNTH = 1 CUANUARY) 


;YEAR = 1980 


sSAVE AF. HL 


;DECREMENT TICK COUNT 
7;JUMP IF TICK NOT ZERO 
;SET TICK COUNT BACK TQ DEFAULT 


:SAVE BC. DE 


70 = DEFAULT FOR SECONDS, MINUTES. HOURS 


7;POQINT AT SECONDS 
7 INCREMENT TO NEXT SECOND 


:SECONDS = 60? 
s;EXIT IF LESS THAN 60 SECONDS 


INCMTH: 
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LD (HL),B s;ELSE SECONDS = 0 

; INCREMENT MINUTES 

INC HL. POINT AT MINUTES 

INC CHL) > INCREMENT TQ NEXT MINUTE 
LD A, CHL) 

CP &0 :MINUTES = 60? 

JR C,EXIToO s;EXIT IF LESS THAN 60 MINUTES 
LD (HL).B sELSE MINUTES = 0 

7 INCREMENT HOUR 

INC HL sPQINT AT HOUR 

INC CHL) 7 INCREMENT TO NEXT HOUR 

LD A, CHL) 

CP 24 s;HOURS = 24? 

IR C,EXITO s;EXIT IF LESS THAN 24 HOURS 
LD (HL).B ‘ELSE HOUR = 0 

7 INCREMENT DAY 

EX DE. HL 7;SAVE ADDRESS OF HOUR 

LD HL,LASTDY-1 

LD A. (MONTH) GET CURRENT MONTH 

LD C,A sREGISTER C = MONTH 

LD B.O 

ADD HL, BC ;PQINT AT LAST DAY QF MONTH 
EX DE, HL s;RESTORE ADDRESS OF HOUR 
INC HL s:POINT AT DAY 

LD A, CHL) 7;GET CURRENT DAY 

INC CHL) s INCREMENT TQ NEXT DAY 

EX DE, HL 7;DE = ADDRESS OF DAY 

LD B,A ;REGISTER B = DAY 

CP CHL) ?IS CURRENT DAY END OF MONTH? 
EX DE, HL s;HL = ADDRESS OF DAY 

JR C,EXITO 7;EXIT IF NOT AT END OF MONTH 


:DETERMINE IF THIS IS END OF FEBRUARY IN A LEAP 
; YEAR (YEAR DIVISIBLE BY 4) 


LD A,C ;GET MONTH 

cP 2 ;IS THIS FEBRUARY? 

JR NZ, INCMTH :JUMP IF NOT. INCREMENT MONTH 
LD A, (YEAR) 7;IS IT A LEAP YEAR? 

AND 00000011B 

JR NZ, INCMTH ;JUMP IF NOT 

:FEBRUARY OF A LEAP YEAR HAS 29 DAYS. NOT 28 DAYS 

LO A,B ;GET DAY 

CP 29 

JR C,EXITO sEXIT IF NOT 1ST OF MARCH 

LD B,1 ;DEFAULT IS 1 FOR DAY AND MONTH 
LD (HLD.B :DAY = 1 

INC HL 

INC CHL) s INCREMENT MONTH 


LD A,C 7GET OLD MONTH 


430 ow wrerrvers 


EXITO: 


EXIT1: 


LASTDBY: 


CLKVAR: 
TICKs 
SEC: 
MIN: 
HOLIR: 
DAY: 
MONTH: 
YEAR: 


~78 “38 46 WS CE 


TCKIDX 


CP 
JR 
LD 


12 
NC,EXITO 
(HL),B 


s INCREMENT YEAR 


LD 
INC 
LD 


sRESTORE REGISTERS 


POP 
POP 


POP 
POP 
EI 
RET! 


HL, (YEAR) 


HL 


(YEAR). HL 


DE 
BC 


HL. 
AF 


7;WAS OLD MONTH DECEMBER? 
s;EXIT IF NOT 

;ELSE 

: CHANGE MONTH TO 1 CJANUARY) 


sRESTORE BC. DE 


sRESTORE HL. AF 


sREENABLE INTERRUPTS 
7RETURN 


sARRAY OF LAST DAYS OF EACH MONTH 


DB 
DB 
DB 


31 
28 
31 
30 
31 
30 
31 
31 
30 
31 
30 
31 


:CLOCK VARIABLES 


DS 
DS 
DS 
DS 
DS 
DS 
DS 


Pp) pe ee fet ee pee foe 


SAMPLE EXECUTION 


7;CLOCK VARIABLE INDEXES 


EQu 


2) 


: JANUARY 
sFEBRUARY CEXCEPT LEAP YEARS) 
+ MARCH 

7; APRIL 
MAY 

3 JUNE 

s JULY 

s AUGUST 

: SEPTEMBER 
; OCTOBER 

s NOVEMBER 
; DECEMBER 


TICKS LEFT IN CURRENT SECOND 
7;SECONDS (0 TO 39) 

sMINUTES (O TO SY) 

sHOURS (€O TO 23) 

sDAY (1 TO NUMBER OF DAYS IN A MONTH) 
?MONTH 1=JANUARY .. 12=DECEMBER 

7 YEAR 


s INDEX TO TICK 


Ct i) | ee | 


SECIDX 
MINIDX 
HRIDX 
DAY IDX 
MTHIDX 
YRIDX 


SC1LID: 


WAITYR: 


1D REAL-TIME CLOCK AND CALENDAR (CLOCK) 434 


EQu 1 ? INDEX TO SECOND 

EQU 2 7; INDEX TO MINUTE 

EQU 3 s INDEX TQ HOUR 

EQU 4 7; INDEX TO DAY 

EQUI 2 ? INDEX TO MONTH 

EQU 6 7 INDEX TO YEAR 

CALL ICLK INITIALIZE CLOCK 

sINITIALIZE CLOCK TO 2/7/83 14:00:00 (2 PM. FER. 7, 1983) 
rics CLOCK 7;HL = BASE ADDRESS OF CLOCK VARIABLES 
PUSH HL 

POP IX 7;IX = ADDRESS OF TICKS 

LO CIX+SECIDX),0O 7;SECONDS = 0 

LD CIX+MINIDX).0 MINUTES = 0 

LD CIX+HRIDX), 14 ;HOUR = 14 (2 PM) 

LD CIX+DAYIDX).7 DAY = 7 

LD CIX+MTHIDX),2 sMONTH = 2 (FEBRUARY) 

LD HL. 1983 

LD CIX+YRIDX),L 7;YEAR = 1983 

LD CIX+YRIDX+1).H 

EI 


;WAIT FOR CLOCK TO BE 2/7/83 14:01:20 (2:01.20 PM, FEB.7, 1983) 
7;IX = BASE ADDRESS OF CLOCK VARIABLES 


:NOTE: MUST BE CAREFUL TO EXIT IF CLOCK IS ACCIDENTALLY 
> SET AHEAD. IF WE CHECK ONLY FOR EQUALITY, WE MIGHT NEVER 
; FIND IT. THUS WE HAVE >= IN TESTS BELOW, NOT JUST =. 


sWAIT FOR YEAR >= 1983 


LD DE, 1983 

DI *;DISABLE INTERRUPTS TO LOAD 2-BYTE YEAR 
LD H. CIX+YRIDX+1) +:GET YEAR 

LD L, (IX+YRIDX) 

EI 

OR A sCLEAR CARRY 

SBC HL, DE ;COMPARE YEAR, 1983 

JR C.WAITYR ‘JUMP IF NOT 1983 

;WAIT FOR MONTH >= 2 

PUSH IX 

POP HL 7;HL = BASE ADDRESS OF CLOCK VARIABLES 
LD DE.MTHIDX 

ADD HL, DE 7;POINT AT MONTH 

LD B,2 

CALL WAIT ;WAIT FOR FEBRUARY OR LATER 

;WAIT FOR DAY >= 7 

DEC HL POINT AT DAY 

LD B,7 

CALL WAIT :WAIT FOR 7TH OR LATER 


;WAIT FOR HOUR >= 14 
DEC HL. sPOINT AT HOUR 


432 rerrvers 


LD B,14 
CALL WAIT *WAIT FOR 2 FM OR LATER 
sWAIT FOR MINUTE >= 1 
DEC HL sPQINT AT MINUTE 
LD B,1 
CALL WAIT sWAIT FOR 2:01 OR LATER 
sWAIT FOR SECOND >= 20 
DEC HL. sPOINT AT SECOND 
LD B, 20 
CALL WAIT *WAIT FOR 2:01.20 OR LATER 
* DONE 
HERE = 
JP HERE s:IT IS NOW TIME OR LATER 
§ RRRNRKHMHKRHKKRARRKRAREKKNEKRAK RRNA 
sROUTINE: WAIT 
;PURPOQSE: WAIT FOR VALUE POINTED TO BY HL 
3 TO BECOME GREATER THAN OR EQUAL TO VALUE IN B 
sENTRY: HL = ADDRESS OF VARIABLE TO WATCH 
; B = VALUE TO WAIT FOR 
sEXIT: WHEN B >= CHL) 
sUSED: AF 
s KHRHKKRAKKHHKRAMKKHARRKRKKKRHH RRR 
WAIT: 
LD A, CHL) sGET PART OF CLOCK TIME 
cP B sCOMPARE TO TARGET 
JR C,WAIT sWAIT IF TARGET NOT REACHED 
RET 


Aocendix A Z80 Instruction Set 
Summary 





MAIN REG SET ALTERNATE REG SET 


ceo { __—--- DS —om4/d4BCO0""' -—— 


ACCUMULATOR FLAGS ACCUMULATOR FLAGS 
A F A’ F’ 
Poe fie foe | ie | 
GENERAL 
PURPOSE 
REGISTERS 
er ae a 


INTERRUPT MEMORY 
VECTOR REFRESH 


1 R 
SPECIAL 
reese 


Figure A-1. Z80 internal register organization 





433 
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CARRY FLAG 
ADD/SUBTRACT FLAG 
PARITY/OVERFLOW FLAG 
HALF-CARRY FLAG 

ZERO FLAG 

SIGN FLAG 

NOT USED 





Figure A-2. Organization of the Z80 flag register 
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MASKABLE (INT) 
MODE 0 


PLACE INSTRUCTION ONTO DATA BUS DURING INTACK = Mie [ORQ LIKE 8080A 
MODE 1 

RESTART TO 38,, OR 56,, (‘RST 56’) 
MODE 2 


USED BY 280 PERIPHERALS 










INTERRUPT 
SERVICE LOW ORDER 
ROUTINE | Low ORDER | | REGISTER 8-BIT VECTOR 
STARTING CONTENTS FROM PERIPHERAL 
ADDRESS HIGH ORDER 
TABLE 





NON MASKABLE (NMI) 
RESTART TO 66, OR 102,, 
INTERRUPT ENABLE / DISABLE FLIP-FLOPS 


ACTION IFF, FF, 


CPU RESET 


DI 


El 


LD A, | IFF.- PARITY FLAG 
LD A, R IFF. - PARITY FLAG 


ACCEPT NMI 


RETN IFF, - IFF, 


ACCEPT INT 


RETI 





“e” INDICATES NO CHANGE 


Figure A-3. Z80 interrupt structure 
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Table A-4. Z80 Instructions in Alphabetical Order 


ADC HL, ss 
ADC A, s 
ADD A,n 
ADD A,r 


ADD A, (HL) 


ADD A, (IX+d) 


ADD A, (1Y+d) 


ADD HL, ss 
ADD IX, pp 
ADD IY, rr 


AND s 


BIT b, (HL) 
BIT b, (IX+d) 
BIT b, (1Y+d) 


BIT b,r 


CALL cc, nn 


CALL nn 


CCF 
CP s 


CPD 


CPDR 


CPI 


CPIR 


Add with Carry Reg. pair ss to HL 
Add with carry operand s to Acc. 
Add value n to Acc. 

Add Reg. r to Acc. 

Add location (HL) to Acc. 

Add location (1X+d) to Acc. 

Add location (1Y+d) to Acc. 

Add Reg. pair ss to HL 

Add Reg. pair pp to IX 


Add Reg. pair rr to lY 


Logical ‘AND’ of operand s and Acc. 


Test BIT b of location (HL) 
Test BIT b of location ({X+d) 
Test BIT b of location (IY+d) 


Test BIT b of Reg. r 


Call subroutine at location nn if 
condition cc if true 


Unconditional call subroutine at 
location nn 


Complement carry flag 
Compare operand s with Acc. 


Compare location (HL) and Acc. 
decrement HL and BC 


Compare location (HL) and Acc. 
decrement HL and BC, repeat 
until BC=0 


Compare location (HL) and Acc. 
increment HL and decrement BC 


Compare location (HL} and Acc. 
increment HL, decrement BC 
repeat until BC=0 


CPL 
DAA 
DEC m 
DEC IX 
DEC IY 
DEC ss 
DI 


DJNZe 


El 

EX (SP), HL 
EX (SP), IX 
EX (SP), lY 


EX AF, AF’ 
EX DE, HL 


EXX 


HALT 


IMO 
IM 1 
IM 2 


IN A, (n) 
IN r, (C) 


INC (HL) 
INC IX 


INC (IX+d) 


Complement Acc. (1's comp) 
Decimal adjust Acc. 
Decrement operand m 
Decrement |X 

Decrement LY 

Decrement Reg. pair ss 
Disable interrupts 


Decrement B and Jump 
relative if B40 


Enable interrupts 

Exchange the location (SP) and HL 
Exchange the location (SP) and |X 
Exchange the location (SP) and 1Y 


Exchange the contents of AF 
and AF’ 


Exchange the contents of DE 
and HL 


Exchange the contents of BC, DE, 
HL with contents of BC’, DE’, HL’ 
respectively 


HALT (wait for interrupt or reset) 


Set interrupt mode 0 
Set interrupt mode 1 
Set interrupt mode 2 


Load the Acc. with input from 
device n 


Load the Reg. r with input from 
device (C) 


Increment location (HL) 
Increment IX 


Increment location (1 X+d) 
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INC IY 


INC (1Y+d) 
INC r 
INC ss 


IND 


INDR 


INI 


INIR 


JP (HL) 
JP (1X) 
JP (1Y) 


JP cc, nn 


JP nn 


JP Cre 


JRe 


JP NC, e 


JR NZ, e 


JR Z,e 
LD A, (BC) 
LD A, (DE) 


LD A,| 


Table A-4. (Continued) 


Increment LY 


Increment location (1Y+d) 
Increment Reg. r 
Increment Reg. pair ss 


Load location (HL) with input 
from port (C), decrement HL 
and B 


Load location (HL) with input 
from port (C), decrement HL and 
decrement B, repeat until B=0 


Load location (HL) with input 
from port (C); and increment HL 
and decrement B 


Load location (HL) with input 
from port (C), increment HL 
and decrement B, repeat until 
B=0 


Unconditional Jump to (HL) 
Unconditional Jump to (1X) 
Unconditonal Jump to (1Y) 


Jump to location nn if 
condition cc is true 


Unconditional jump to location 
nn 


Jump relative to PC+e if carry=1 


Unconditional Jump relative 
to PC+e 


Jump relative to PC+e if carry=0 


Jump relative to PCt+e if non 
zero (Z=0) 


Jump relative to PC+e if zero (Z=1) 
Load Acc. with location (BC) 
Load Acc. with location (DE) 


Load Acc. with | 


LD A, (nn) 
LD A, R 
LD (BC),A 
LD (DE),A 
LD (HL), n 
LD dd, nn 
LD HL, (nn) 
LD (HL),r 
LDI,A 

LF IX, nn 


LD IX, (nn) 


LD (IX+d), n 
LD (IX+d),r 


LD IY, nn 


LD IY, (nn) 


LD (1Y+d), n 


LD (lY¥+d), r 


LD (nn), A 


LD (nn), dd 


LD (nn), HL 


LD (nn), 1X 
LD (nn), 1Y 
LD R,A 


LD r, (HL) 


LD r, (IX+d) 


LD r, (1¥+d) 


LDr,n 
LDr,r’ 


LD SP, HL 
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Load Acc. with location nn 
Load Acc. with Reg. R 

Load location (BC) with Acc. 
Load location (DE) with Acc. 
Load location (HL) with value n 


Load Reg. pair dd with value nn 


Load HL with location (nn) 

Load location (HL) with Reg. r 
Load | with Acc. 

Load |X with value nn 

Load 1X with location (nn) 

Load location (1X+d) with value n 
Load location (1X+d) with Reg. r 
Load IY with value nn 

Load 1Y with location (nn) 

Load location (1Y+d) with value n 
Load location (1Y+d) with Reg. r 
Load location (nn) with Acc. 
Load location (nn) with Reg. pair dd 
Load location (nn) with HL 

Load location (nn) with IX 

Load location (nn) with lY 

Load R with Acc. 

Load Reg. r with location (HL) 
Load Reg. r with location (1X+d) 
Load Reg. r with location (1Y+d) 
Load Reg. r with value n 

Load Reg. r with Reg. r’ 


Load SP with HL 
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Table A-4. (Continued) 


LD SP, IX 
LD SP, IY 


LDD 


LDDR 


LDI 


LDIR 


NEG 
NOP 


OR s 
OTDR 


OTIR 


OUT (C), r 


OUT (n),A 
OUTD 


OUT 


POP IX 
POP IY 
POP qq 
PUSH IX 
PUSH IY 


PUSH qq 


Load SP with IX 
Load SP with lY 


Load location (DE) with location 
(HL), decrement DE, HL and BC 


Load location (DE) with location 
(HL), decrement DE, HL and BC; 
repeat until BC=0 


Load location (DE) with location 
(HL), increment DE, HL, 
decrement BC 


Load location (DE) with location 
(HL), increment DE, HL, 
decrement BC and repeat until 
BC=0 


Negate Acc. (2’s complement) 


No operation 


Logical ‘OR’ or operand s and Acc. 
Load output port (C) with location 
(HL) decrement HL and B, repeat 
until B=0 


Load output port (C) with location 
(HL), increment HL, decrement B, 
repeat until B=0 


Load output port (C) with Reg. r 


Load output port (n) with Acc. 


Load output port (C) with location 
(HL), decrement HL and B 


Load output port (C) with location 
(HL), increment HL and decrement 
B 


Load IX with top of stack 

Load IY with top of stack 

Load Reg. pair qq with top of stack 
Load |X onto stack 

Load IY onto stack 


Load Reg. pair qq onto stack 


RES b, m 


RET 
RET cc 


RETI 
RETN 

RL m 

RLA 

RLC (HL) 
RLC (1X+d) 
RLC (1Y+d) 
RLCr 
RLCA 


RLD 


RR m 
RRA 
RRC m 
RRCA 


RRD 


RST p 


SBC A, s 


SBC HL, ss 


SCF 

SET b, (HL) 
SET b, (1X+d) 
SET b, (1Y+d) 


SET b, r 


Reset Bit b of operand m 


Return from subroutine 


Return from subroutine if condition 
cc is true 


Return from interrupt 

Return from non maskable interrupt 
Rotate left through carry operand m 
Rotate left Acc. through carry 
Rotate location (HL) left circular 
Rotate location (I1X+d) left circular 
Rotate location (1Y+d) left circular 
Rotate Reg. r left circular 

Rotate left circular Acc. 


Rotate digit left and right between 
Acc. and location (HL) 


Rotate right through carry operand m 
Rotate right Acc. through carry 
Rotate operand m right circular 
Rotate right circular Acc. 


Rotate digit right and left between 
Acc. and location (HL) 


Restart to location p 


Subtract operand s from Acc. with 
carry 


Subtract Reg. pair ss from HL with 
carry 


Set carry flag (C=1) 

Set Bit b of location (HL) 
Set Bit b of location (1X+d) 
Set Bit b of location (1 Y+d) 


Set Bit b of Reg. r 
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Table A-4. (Continued) 


Subtract operand s from Acc. 


Shift operand m left arithmetic 


Shift operand m right arithmetic Exclusive ‘OR’ operand s and Acc. 


Shift operand m right logical 





Table A-2. Z80 Operation Codes in Numerical Order 


OBJECT CODE INSTRUCTION 
00 NOP 


01 yyyy LD BC, data16 










































13 
14 
15 
16 yy 

17 

18 disp-2 










02 LD (BC),A 1B DEC DE 

03 1c INC E 

04 1D DEC E 

05 1E yy LD E,data 
1F RRA 

07 20 disp-2 JR NZ, disp 

08 21 yyyy LD HL, data 16 

09 22 ppaqq LD (addr), HL 

OA 23 HL 

OB 24 H 

OC C 25 H 


OD Cc LD H,data 
OE yy C,data 27 

OF Z,disp 
10 disp-2 disp 29 ADD HL,HL 

11 yyyy LD DE, data16 LD HL (addr) 
12 LD (DE),A 2B HL 


OBJECT CODE 
19 


1A 





INSTRUCTION 
ADD 


LD 





































































2C 
2D 
2E 
2F 


L 
L 
LD L,data 



















NC, disp 
SP, data 16 
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Table A-2. (Continued) 


OBJECT CODE INSTRUCTION 
LD 


(addr),A 









































33 INC SP 
34 INC (HL) 
35 DEC (HL) 

LD (HL),data 
37 SCF 
38 JR C.disp 
39 ADD HL,SP 
3A ppqaq LD A (addr) 
3B DEC SP 





3C 
3D 





INC A 
DEC A 
LD A.data 

























































3F CCF 
LD B.reg 
46 LD B.(HL) 
LD C.reg 
4E LD C (HL) 
LD D.reg 
56 LD DAHL) 
LD E.reg 
5E LD E (HL) 
LD H reg 
66 LD H (HL) 
LD L.reg 
6E LD L(HL) 
LD (HL).reg 





76 



















LD A,reg 
7E LD A (HL) 
ADD A.reg 
86 ADD A (HL) 
ADC A,reg 
8E ADC A (HL) 









reg 









96 SUB (HL) 
SBC A,reg 
9E SBC AHL) 








reg 
(HL) 
reg 
(HL) 
reg 
(HL) 
reg 





A6 











AE 












B6 














BE CP (HL) 

Co RET NZ 

C1 POP BC 
JP NZ, addr 
JP addr 
CALL NZ,addr 
PUSH BC 


A,data 


OBJECT CODE 


CB O Orrr 

CB 06 

CB O Irer 

CB OE 

CB 1 Orrr 

CB 16 

CB 1 Irrr 

CB 1E 

CB 2 Orrr 

CB 26 

CB 2 Irrr 

CB 2E 

CB 3 Irrr 

CB 3E 

CB O1bbbrrr 
CB 01bbb110 
CB 10bbbrrr 
CB 10bbb110 
CB 11bbbrrr 
CB 11bbb110 
CC ppaqq 

CD ppaq 

CE yy 

CF 
DO 
D1 

































INSTRUCTION 
RLC reg 


RLC (HL) 








NC 
DE 





JP NC,addr 
OUT (port),A 
CALL NC, addr 









D5 DE 
data 
10H 


Cc 


















D7 
D8 
D9 




















































DA ppaqq C,addr 

DB yy IN A,(port) 

DC ppaq CALL C,addr 

DD 00xx 9 ADD IX,pp 

DD 21 yyyy LD \X,data16 

DD 22 ppaq LD (addr),IX 

DD 23 INC IX 

DD 2A ppaq LD IX, (addr) 

DD 2B DEC Ix 

DD 34 disp INC (IX + disp) 
DD 35 disp DEC (IX + disp) 
DD 36 disp yy LD (IX + disp),data 
DD 01ddd110 disp LD reg,(IX + disp) 
DD 7 Osss disp LD (IX + disp),reg 
DD 86 disp ADD AIX + disp) 
DD 8E disp ADC AIX + disp) 
DD 96 disp SUB (IX + disp) 
DD 9E disp SBC AJAX + disp) 
DD A6 disp AND (IX + disp) 
DD AE disp XOR (IX + disp) 
DD B6 disp OR (IX + disp) 
DD BE disp CP (IX + disp) 


DD CB disp 06 (IX + disp) 


Table A-2. (Continued) 


OBJECT CODE INSTRUCTION 
RRC 


DD CB disp OE 


(1X + disp) 


DD CB disp 16 RL (1X + disp) 
DD CB disp 1E RR (IX + disp) 
DD CB disp 26 SLA (IX + disp) 
DD CB disp 2E SRA (IX + disp) 
DD CB disp 3E SRL (IX + disp) 
DD CB disp 01bbb110 BIT b(IX + disp) 
DD CB disp 10bbb110 RES b(iX + disp) 
DD CB disp 11bbb110 SET b(IX + disp) 
DD E1 POP IX 
DD E3 EX (SP),1X 
DD E5 PUSH 1x 
DD E9 JP (IX) 
DD F9 LD SP..IX 
DE yy SBC A.data 
DF RST 18H 
EO RET PO 
E1 POP HL 
JP PO, addr 
E3 EX (SP),HL 
CALL PO, addr 
ES PUSH HL 
AND data 
E7 RST 20H 
E8 RET PE 
E9 JP (HL) 
EA ppaqq JP PE, addr 
EB EX DE,HL 
EC ppqq CALL PE, addr 
ED 01ddd000 IN reg,(C) 
ED 01sss001 OUT (C),reg 
ED O1xx 2 SBC HL, rp 
ED 0O1xx 3 ppaq LD (addr),rp 
ED 44 NEG 
ED 45 RETN 
ED 010nn110 IM m 
ED 47 LD LA 
ED O1xxsA ADC HL, rp 
ED 01xx B ppqq LD rp,(addr) 
ED 4D RETI 
ED 4F LD R.A 
ED 57 LD Al 
ED 5F LD A,R 


ED 67 RRD 
ED 6F RLD 
ED AO LDI 
ED Al CPI 
ED A2 INI 
ED A3 OUTI 
ED A8 LOD 
ED AQ CPD 
ED AA IND 
ED AB OUTD 
ED BO LDIR 
ED B1 CPIR 
ED B2 INIR 
ED B3 OTIR 
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OBJECT CODE INSTRUCTION 






EF 
FO 
Fl 






P 
AF 
JP P,addr 









F3 
P,addr 
AF 
data 
30H 
M 
LD SP, HL 









F5 





F7 
F8 
F9 








































FA ppqq M,addr 
FB 
FC ppagq M,addr 








































FD O00Oxx 9 ADD Wer 

FD 21 yyyy LD IY data16 
FD 22 ppaq LD (addr),lY 
FD 23 INC lY 

FD 2A ppaq LD lY (addr) 












FD 2B 

FD 34 disp 

FD 35 disp 

FD 36 disp yy 
FD O1ddd110 disp 
FD 7 Osss disp 
FD 86 disp 

FD 8E disp 

FD 96 disp 

FD 9E disp 

FD A6 disp 


DEC IY 

INC (IY + disp) 
DEC (IY + disp) 

LD (lY + disp),data 
LD reg.(l¥ + disp) 
LD (1Y¥ + disp),reg 
ADD AAIY + disp) 
ADC AAIY + disp) 
SUB (1Y + disp) 
SBC AY + disp) 
AND (1Y + disp) 















FD AE disp XOR (IY + disp) 
FD B6 disp OR (IY + disp) 
FD BE disp CP (IY + disp) 
FD CB disp 06 RLC (IY + disp) 
FD CB disp OE RRC (IY + disp) 
FD CB disp 16 RL (IY + disp) 
FD CB disp 1E RR (IY + disp) 
FD CB disp 26 SLA (IY + disp) 
FD CB disp 2E SRA (IY + disp) 
FD CB disp 3E SRL (IY + disp) 


FD CB disp 01bbb110 
FD CB disp 10bbb110 
FD CB disp 11bbb110 
FD E1 
FD E3 
FD E5 
FD E9 
FD F9 
FE yy 
FF 


BIT b (IY + disp) 
RES b,(IY + disp) 
SET b, (IY + disp) 
POP IY 

EX (SP),IY 
PUSH lY 

JP (1Y) 

LD SP,IY 

data 
38H 













Mnemonic 
LD r, r’ 
LDr,n 


LD r, (HL) 


LD r, (IX+d) 


LD r, (IY+d) 


LD (HL), r 


LD (IX+d), r 


LD (1Y+d), r 


LD (HL), n 


LD (IX+d), n 


LD (1Y+d),n 


LD A, (BC) 
LD A, (DE) 
LD A, (nn) 


LD (BC), A 
LD (DE), A 
LD (nn), A 


Symbolic 
Operation 


rer’ 
ren 

r+ (HL) 
r+ (IX+d) 


r+ (1Y+d) 


(HL) <r 
(IX+d) —r 


(IY+d) «<r 


(HL) <n 


(IX+d) <n 


(lY+d) <n 


A <= (BC) 
A < (DE) 
A «+ (nn) 


(BC)<A 
(DE)<-A 
(nn)<A 


[epeRA STR [6 45 210 


Table A-3. Z80 8-Bit Load Instructions 


Flags 
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eljelele|e/e idl 


00 
01 
11 
01 
il 
01 
01 
11 
01 
1] 
01 


< 


OP-Code 


r 
n 
r 


No. 
of M 
Cycles 


J 
2 


No. 
of T 
Cycles 


Comments 


Ae Reg. 


000 
001 


Notes: __r, r’ means any of the registers A, B,C, D, E, H, L 


IFF the content of the interrupt enable flip-flop (IFF) is copied into the P/V flag 


Flag Notation: e = flag not affected, 0 = flag reset, 1 = flag set, X = flag is unknown, 


t = flag is affected according to the result of the operation. 
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Mnemonic 
LD dd, nn 


LD IX, nn 


LD IY, nn 


LD HL, (nn) 


LD dd, (nn) 


LD IX, (nn) 


LD IY, (nn) 


LD (nn), HL 


LD (nn), dd 


LD (nn), IX 


LD (nn), LY 


LD SP, HL 
LD SP, IX 


LD SP, ly 
PUSH qq 
PUSH IX 
PUSH IY 
POP qq 
POP IX 


POY IY 


Notes: 


Table A-4. Z80 16-Bit Load Instructions 


Symbolic 
Operation 


dd «nn 


IX —nn 


1Y —nn 


H + (nn+1) 
L+ (nn) 


dd) + (nn) 


IXy + (nn+1) 
IX) + (nn) 


Yu + (nnt1) 


IY) + (nn) 
(nn+1) +-H 
(nn) + L 


(nn+1) +«- dd 
(nn) — dd, 


H 


(nn+1) <— iXy 
(nn) < IX 


(nn+1) «+ IY 
(nn) «+ TY, 


H 


SP + HL 
SP + 1X 


SP+IY 


(SP-2) ~ aq, 
(SP-1) + 444s 
(SP-2) + IX) 
(SP-1) — IX 
(SP-2) — IY, 
(SP-1) «- TY}; 
994 (SP+1) 
aq; (SP) 

IXy + (SP+1) 
IX) «+ (SP) 

Wu + (SP+1) 
TY, + (SP) 
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Flags 


Le|2| Ms] n| x] 76 s43 210 


Op-Code 


00 ddO 001 
- n > 
o n —_ 
11 O11 101 
00 100 001 
- n= 
- nn - 
11 111 101 
00 100 001 
- on > 
- n > 
00 101 
-~- nn -— 
~_ nn 
11 101 101 
01 ddl 
- n > 
- no 
11 O11 101 
00 101 010 
ae 
-“ no 
11 111 101 
00 101 010 
on, a 
- no 
00 100 010 
- n _ 
-~ nn 
11 101 161 
01 ddO 01) 
o- n > 
+ n Oo 
11 O11 101 
00 100 010 
- n> 
- nn - 
11 111 101 
00 100 010 
+“ no 
- n = 
11 111 001 
11 011 101 
11 111 00) 
1t L111 101 
11 111 001 
11 qqO 101 


11 011 101 
11 100 101 
11 th1 101 
11 100 101 
11 qqO 001 


11 011 101 
11 100 001 
11 111 101 
11 100 001 


dd 1s any of the register pairs BC, DE, HL, SP 


qq ts any of the register pairs AF, BC, DE, HL 
(PAIR) (PAIR), refer to high order and low order eight bits of the register pair respectively. 


Flag Notation: 


Eg. BC, =C, AF y =A 


No. 


Bytes 


No. 
of M 
Cycles 


# = flag not affected, 0 = flag reset, 1 = flag set, X = flag is unknown, 
t flag is affected according to the result of the operation. 


No. 
of T 
States 


10 


14 


20 


20 


20 


16 


20 


20 


20 


10 


10 


1 


1S 


15 


10 


Comments 
dd Pair 
00 BC 
01 DE 
10 HL 
11 SP 
aq Pair 
00 BC 
01 DE 
10 HL 
11 AF 
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Table A-5. Z80 Exchange, Block Transfer, and Block Search Instructions 


Flags Op-Code 


P No. No. No. 
Symbolic / of of M of T 
Mnemonic Operation C Vv 76 543 210 | Bytes Cycles | States | Comments 
elele 011 


EX DE, HL DE --HL ejefelit 101 1 1 4 
EX AF, AF’ AF -> AF’ elelelele}e 00 001 000 I 1 4 
EXX (be}-(e-) elelejej;ele {ii 011 001 | 1 1 4 ‘Register bank and 
DE #4 DE’ auxiliary register 
H L" bank exchange 
EX (SP), HL H + (SP+1) elelejelele {il 100 O11 1 5 19 
L + (SP) 
EX (SP), IX IX, (SP+1) @elejlelejele fll O11 101 2 6 23 
IX, + (SP) 11 100 011 
FX (SP), IY TY *(SP+ 1) elejejele;e fil 111 101 2 6 23 
TY, + (SP) 11 100 011 
® 
LDI (DE) — (HL) efe;t}e;O;]OF1l 101 101 2 4 16 Load (HL) into 
DE + DE+1 10 100 000 (DE), increment the 
| pointers and 
HL ~ HL+1 decrement the byte 
BC + BC-1 counter (BC) 
LDIR (DE) + (HL) ele/Oje]O; O]11 I10f 101 2 5 21 If BC #0 
DE — DE+1 10 110 000 2 4 16 If BC=0 
HL+ HL+! 
BC + BC-1 
Repeat until 
BC = 0 
® 
LDD (DE) «- (HL) ejeltites/o;O fil lol tol 2 4 16 
Dk + DF-1 10 101 000 
HL -HL-1 
BC + BC-1] 
LDDR (DI) + (HL) efelOle/ oO] OFF 101 101 2 5 21 if BC #0 
DE — DE-1 10 111 000 2 4 16 If BC=0 
HL «HL-1 
BC < BC-1 
Repeat until 
BC =0 
QO 
CPI : A - (HL) ey) t) t,t) a) t pli iol 10) 2 4 | 16 
HL - HL+1 10 100 001 
BC + BC- 1 
QO 
CPIR A - (HL) erry ty] ty} iy t yal 101 tol 2 5 21 If BC # O and A # (HL) 
HL +HL+1 10 110 001 2 4 16 If BC = 0 or A = (HL) 
BC + BC-1 
Repeat until 
A = (HL) or 
BC = 0 
QO 
CPD A - (HL) e;ty ty ty byt fil iol 100i 2 4 16 
HL + HL-1 10 101 00! 
BC + BC-1 
QO 
CPDR A - (HL) ee; ryt} ty ty t yil io) 101 2 5 21 If BC # O and A # (HL) 
HL +HL-1 10 111 001 2 4 16 If BC = 0 or A = (HL) 
BC + BC-1 
Repeat until 
A = (HL) or 
BC =0 


Notes: () P/V flag is 0 if the result of BC-1 = 0, otherwise P/V = 1 
@ Z flagis 1 if A = (HL), otherwise Z = 0, 


llag Notation: = flag not affected, 0 = flag reset. | = flag set, X = flag is unknown, 
t = flag 1s affected according to the result of the operation. 
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Table A-6. Z80 8-Bit Arithmetic and Logical Instructions 


Mnemonic 


ADD A,r 
ADD A,n 


ADD A, (HL) 
ADD A, (IX+d) 


ADD A, (IY+d) 


ADC A,s 
SUB s 

SBC A,s 
AND s 

OR s 

XOR s 

CP s 

INC r 

INC (HL) 
INC (1X+d) 


INC (TY +d) 


Symbolic 

Operation 
A<«Atr 
A«+Atn 


A+ A+(HL) 
A-A + (I[X+d) 


A~A+(lY+d) 


A«~A+t+s+CY 
A«-A-s 
A+A-s-CY 
A«+A A Ss 
A+A V 5 
A«~A®s 
A-Ss 
r-rt | 
(HL) « (HL)+1 


(IX+d) <— 
(X+d)+1 


(1Y+d) + 
(1¥Y+d) + 1 


m¢em-1 


t 


Se a oe ee oe oe noe 


Flags 


fr 
CiZIVIS|N 
tit} Viti ort 


Vv 


<< << 9 ee eS SS 


t 


be oe I eo oe oe oe oe 2 


t 


we er 7H OOo ree + 


Op-Code 


76 543 210 


10 [000] I 
11 [000] 110 
_ n > 
10 [000] 110 


1] O11 101 


10 |000} 110 


- d — 
11 111 101 
10 [000] 110 


- d- 


00 r {LOO 
00 110[100] 
11 O11 JO] 


00 110[100] 
« d * 
1 dtl 101 
00 °110[100) 
- d be 

101 


No. 

of M 
Cycles 
1 

2 


No. 
of T 
States 
4 


‘| 


Comments 


if Reg. 
000 
001 
010 
011 
100 
101 
111 


sis any of r,n, 
(HL), (1X+d), 

(TY +d) as shown for 
ADD instruction 


The indicated bits 
replace the 000 in 
the ADD set above. 


m is any of r, (HL), 
(IX+d), (Y+d) as 
shown for INC 
Same format and 
States as INC. 
Replace 100 with 
101 in OP code. 


The V symbol in the P/V flag column indicates that the P/V flag contains the overflow of the result of the 
operation Similarly the P symbol indicates partty. V = 1 means overflow, V = 0 means not overflow. P = | 
means parity of the result is even, P = 0 means panty of the result is odd. 


Flag Notation: 


e = flag not affected, 0 = flag reset, | = flag set, X = flag is unknown, 


¢ = flag is affected according to the result of the operation. 
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Table A-7. Z80 General-Purpose Arithmetic and CPU Control 


Flags 


Symbolic y 
Mnemonic Operation C Vv 76 543 210 


Op-Code 


00 


11 
01 
00 


00 
00 
01 
11 
11 


11 
01 
1} 
01 
11 


101 


101 
000 
111 


110 
000 
110 
110 
111 


101 
000 
101 
010 
101 


111 


101 
100 
111 
111 
000 
110 
011 
011 


101 
110 
101 
110 
101 


DAA Converts acc. tT} tt Pitie!¢ |00 100 111 
content into 
packed BCD 
following add 
or subtract 
with packed 
BCD operands 
CPL AcA ejelele!i {1 
NEG A<«O0O-A titi Vi¢tiilt 
CCF CY<CY tlelelelolx 
SCF CY «1 lj] elelel0/0 
NOP No operation |e@|e]/elelele 
HALT CPU halted eleleleleie 
DI IFF —0 eleljelelele 
EI IFF <— 1 elejeljeleie 
IM 0 Set interrupt |e] e]e|/e];e/e 
mode 0 
IM 1 Set interrupt e|elelelele 
mode 1 
IM2 Set interrupt |e] e|e]/e|/eje 
mode 2 


Notes: _ IFF indicates the interrupt enable flip-flop 
CY indicates the carry flip-flop. 


01 


011 


110 


No. 
of M 
Cycles 


1 


Flag Notation: e = flag not affected, 0 = flag reset, 1 = flag set, X = flag is unknown, 


+ = flag is affected according to the result of the operation. 


No. 
of T 
States 


4 


Comments 


Decimal adjust 
accumulator 


Complement 
accumulator 

(one’s complement) 
Negate acc. (two’s 
complement) 


Complement carry 
flag 


Set carry flag 
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Table A-8. 780 16-Bit Arithmetic Instructions 


; No. No. 
Symbolic Flags Oped rs) of M of T 


Mnemonic Operation C] Zp S[N]H|76 543 210 | Cycles | States | Comments 
¢ e 


ADD HL, ss HL «+ HL+ss @ 0 |X j00 ssl 001 3 11 


ADC HL, ss HL+HL+ss+CY|t¢ V 0 |X ;11 101 101 
01 ssl 010 
SBC HL, ss HL+HL-ss-CY |t Xj11 101 101 
01 ssO 010 
ADD IX, pp IX + 1X + pp 11 O11 101 
00 ppl 001 


IY<lY+ rr 


ss + ss + 1 
IX+IX+ 1] 
IY+I1Y+1 
ss + ss - | 
IX+IX-1 


IY<IY-1 


Notes: ss is any of the register pairs BC, DE, HL, SP 
pp is any of the register pairs BC, DE, IX, SP 
rr_ is any of the register pairs BC, DE, 1Y, SP. 


Flag Notation: e = flag not affected, 0 = flag reset, | = flag set, X = flag is unknown, 
t = flag is affected according to the result of the operation. 
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Table A-9. Z80 Rotate and Shift Instructions 


Flags Op-Code 
P No. No. No. 
Symbolic / of ‘of M of T 
Mnemonic Operation C Vv 76 543 210} Bytes { Cycles | States | Comments 
RLCA aaa tlele;fe!0!0 700 000 111 1 1 4 Rotate left circular 
accumulator 
RLA eet —_— nil tj}e}e;e!0);0]00 010 111 1 1 4 Rotate left 
A accumulator 
RRCA Peer tlelejel0/0]00 001 111] 1 1 4 Rotate right circular 
‘ accumulator 
RRA bee = tje;ele{/0}0/00 011 111] 1 1 4 Rotate right 
“ accumulator 
RLCr titi P/]+]0}01]11 001 011 2 2 8 Rotate left circular 
00 [000] . register r 
RLC (HL) tit} P]+]O]0]11 001 O11 2 4 15 r Reg. 
00 [000]110 000 B 
RLC (IX+d) t|+]P]+]o]jo]ii 011 101) 4 6 23 or 6° 
r, (HL), (IX+d), (IY +d) 11 001 O11 4 
«- d- 100 H 
of) os 
RLC (1Y+d) +/+] P]+]Oj;0]11 111 101 4 6 23 
11 00) O11 
- d > 
00 [000] 110 
RLm titi Plt {oo Instruction format and 
Flea arava states are as shown 
vere : for RLC,m. To form 
new OP-code replace 
RRC m rl — 37 t{t|Pl+]ojo| 001} (000) of RLC,m with 
m ~r, (HL), (IX+d). (Yd) shown code 
RRm a eel t}t/P14]o}o 
m =r, (HL), (IX+d), (IY+d) 
SLA m o |t]t{P]+]o]o 
m =r, (HL), (IX+d), (f¥+d) 
1 —e 0 
SRA m al tit|P1+|o]o 
m =r, (HL), (IX+d), (IV+d) 
SRL m 0 t}+]P}+jojo| (iii) 
m= r (HL), (IX+d), (1Y+d) 
RLD ap_ 4b fF =P ss dente fs iPi+{olojii 101 101) 2 5 18 Rotate digit left and 
= 01 101 111 right between the 
accumulator 
= and location (HL). 
RRD al7__4f3 coc @eit{/P/tjO;O]11 101 101 2 5 18 The content of the 
01 100 111 upper half of the 
accumulator is 
unaffected 


Flag Notation: e = flag not affected, 0 = flag reset, 1 = flag set, X = flag is unknown, 
+ = flag is affected according to the result of the operation. 
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Table A-10. Z80 Bit Manipulation Instructions 


Flags Op< ode 


P ‘ ‘ No. 
Symbolic / of T 
Mnemonic Operation C Vv 76 543 210 States | Comments 
e 1 


BIT b, Z+T, t| xX] X]/0O]1]11 001 011 8 
01 b r 
BIT b, (HL) Z + (HL), ti x] X 1 011 12 
01 110 
BIT b, (IX+d) Z + (IX+d), xX] X 11 101 20 
11 011 
110 Bit Tested 
BIT b, (IY +d) Z + (IY+d), 101 
011 


> 


110 


SET b, r Ho! 


SET b, (HL) (HL), +1 


SET b, (IX+d) (IX+d),, «1 


SET b, (IY+d) (IY +d), -1 


s 0 To form new OP- 


= code replace 
7 eae of SET b,m with 
: . Flags and time 
(IY +d) g 
states for SET 
instruction 


Notes: The notation Sp indicates bit b (0 to 7) or location s. 


Flag Notation: © = flag not affected, 0 = flag reset, | = flag set, X = flag is unknown, 
¢ = flag is affected according to the result of the operation. 
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Table A-44. Z80 Jump Instructions 






Flags Op-Code 
P No. No. No. 
Symbolic / of of M of T 
Mnemonic Operation Cc 1 Vv 76 543 210| Bytes Cycles | States | Comments 
JP nn PC —nn e},elejejelfe]i1 000 O11 3 3 10 
- n > 
- n > cc Condition 
JP cc, nn If conditioncc| e] e}e jejeje} li cc 010 3 3 10 000 | NZnon zero 
is true PC —nn, oe Tn. SS 001 | Z zero 
otherwise 010 | NCnon carry 
continue ia 011 | C carry 
100 | PO parity odd 
101 | PE parity even 
110 | P sign positive 
JRe PC +-PC +e @e|}e];eje!e}]e] 00 011 000 2 3 12 111 | M_ sign negative 
- e~2 > 
IR C,e IfC =0, @| ele jel]e;e!00 111 000 2 2 7 If condition not met 
continue 
-_ e-2 _s 
IfC = 1, 2 3 12 If condition is met 
PC + PCte 
JR NC,e IfC = 1, ej} ele lejeje! 00 116 000 2 2 7 If condition not met 
continue 
- e-2 - 
If C=0, 2 3 12 If condition ts met 
PC +PCt+e 
JR Z,e If Z=0 e;el/efet;e};e; 00 101 000 2 2 7 If condition not met 
continue 
- e-2 -> 
If Z = 1, 2 3 12 If condition is met 
PC -+PCte 
JR NZ,e If Z=1, @| e}efel}e]e; 00 100 000 2 2 7 If condition not me 
continue bis eed ey 
IfZ=0, 2 3 12 If condition met 
PC —PC+e 
JP (HL) PC —~HL ejelejetete! ii 101 001 ] 1 4 
JP (1X) PC — IX ejejleleje!e)] ii O11 101 2 2 8 
11 101 001 
JP (1Y) PC «IY ejelejeje);e; 11 111 101 2 2 8 
11 101 001 
DJNZ,e B< B-l @e| ej} e@ lele{e}! 00 010 000 2 2 8 IfB=0 
If B = 0, 
-e-2 > 
continue 
If B #0, 2 3 13 IF B#0 
PC +PCt+e 
Notes: _e represents the extension in the relative addressing mode. 


Flag Notation: 


e is a signed two’s complement number in the range <-126, 129> 


e-2 in the op-code provides an effective address of pc te as PC is 


incremented by 2 prior to the addition of e. 


+ = flag is affected according to the result of the operation. 


e = flag not affected, 0 = flag reset, 1 = flag set, X = flag is unknown, 
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Table A-42. Z80 Call and Return Instructions 


Flags Op-Code 


P No. No. No. 
Symbolic / of of M of T 
Mnemonic Operation Cc Vv 76 543 210] Bytes Cycles | States | Comments 


CALL nn (SP-1)+PC,, @eljelej;ete;e]il 001 101 3 5 17 
(SP-2)<PC, - n — 
PC+-nn - on > 


CALL cc, nn If condition : If cc is false 
cc is false 
continue, 
otherwise 
same as 
CALL nn 


If cc is true 


PC, (SP) 001 001 
PC, +{SP+ 1) 


If condition If cc is false 
cc is false 


continue, Hecke ae 
otherwise cc is tru 


same as ; Condition 


RET non zero 
zero 
non carry 
Return from 101 101 carry 
a 001 101 parity odd 
parity even 
sign positive 
sign negative 


Return Leh 101 101 
non maskable 

interrupt 000 101 
(SP-1)-PC), t lil 


(SP-2)<PCy 
PCL +0 
PC, +P 


Flag Notation: = flag not affected, 0 = flag reset, 1 = flag set, X = flag is unknown 
¢ = flag is affected according to the result of the operation. 
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Table A-43. Z80 I/O Instructions 








Flags Op-Code 
























INI 


INIR 


INDR 


OUT (n), A 


OUT (C), r 





OTIR 


















OTDR 


Flag Notation: 


be affected 


) 

(HL) + (C) Xi} t}] X} XP1 > XP 11 101 101 
B<-B-1 10 100 010 
HL+-HL+1 

(HL) + (C) X{1{ X} X} 1] X}1i 101 101 
B<+-B-1 10 110 010 
HL+HL+1 

Repeat until 

B=0 


(HL) < (C) X{t{] X}X[ 1] Xi} 11 


101 101 
B+B-1 10 101 010 
HL+HL- 1 
(HL) + (C) X] 1] X} X}1] X11 101 101 
B+B-1 10 111 010 
HL + HL-1 
Repeat until 
B=0 


(n)<A ej/ejelelele;il 010 O11 
—n- 
(C)+r @ejeleje;e;e!lii 101 101 
01 r 001 


(C) — (HL) Xx X{ X} 1] xX} it 101 101 
B<-B-1 19 100 O11 
HL<+HL+1 
(C) + (HL) Xi 1{ X{X]} lt X11 101 101 
B+-B-1 10 110 O11 
HL<«+HL +1 
Repeat until 


B=0 


(C) + (HL) xX X} X} 1] Xp11 101 101 
B+B-1] 10 101 O11 
HL+HL-1 

(C) «+ (HL) Xi Lt Xt Xt it Xt tdi 101 101 
B+-B-1 10 111 O11 
HL+HL-1 

Repeat until 

B=0 


2 4 
2 5 
(If B # 0) 
2 4 
(If B = 0) 


2 4 

2 5 
(If B # 0) 

2 4 
(If B = 0) 


2 3 


2 4 
zZ 5 

(If B # 0) 
2 4 


(If B = 0) 


2 4 
5 
(If B # 0) 
2 | 4 
(If B = 0) 


Notes: dd) If the result of B - 1 is zero the Z flag is set, otherwise it is reset - 


e = flag not affected, 0 = flag reset, 1 = flag set, X = flag is unknown, 


+ = flag is affected according to the result of the operation. 


16 


21 


16 


21 


16 


16 


CtoAy~ A, 
~A 


B to Ag 


Cto Ay ~ Ay 
BtoA,~A 


CtoA ~ A, 
~A 


8 


BtoA 


8 


Cto Ay 
BtoA 


8 


nto Ay 


Cto Ay 


BtoA 


CtoA 


8 


Bto Ay 


CtoA 


Bto Ag 


C to Ay 


BtoA 


8 


Cto Ay 


BtoA 


8 


P No. No. No. 
Symbolic / ; of of M of T 
Mnemonic Operation Cc Vv H| 76 543 210] Bytes Cycles | States | Comments 
IN A, (n) A + (n) e elelefe;i1 011 011 2 3 11 nto Ay ~ Ay 
- on > Acc toAg ~Ays 
IN r, (C) r+(C) e PI t?{O] ¢]11 101 101 z 3 12 CtoAy~ A, 
if r= 110 only 01 xr 000 BtoAg~ Ais 
the flags will 


eis 


Acc to Ag ~A 
~ A, 


~A 










~A 
~A 


~ A, 


~A 


~ A, 


ar 


~A 


15 


15 





15 







15 


15 





7 
15 


15 


15 


15 
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Table A-14. Summary of Z80 Flag Operations 


Instruction 
ADD A,s; ADC A,s 
SUB s; SBC A,s, CPs, NEG 


AND s 


OR s; XOR s 


INC s 
DEC m 


ADD DD, ss 

ADC HL, ss 

SBC HL, ss 

RLA; RLCA, RRA, RRCA 
RL m; RLC m; RR m; RRC m 


N 
oc 


> 
—_— O12 


Comments 

8-bit add or add with carry 

8-bit subtract, subtract with carry, compare and 
negate accumulator 

Logical operations 

And set’s different flags 

8-bit increment 

8-bit decrement 

16-bit add 

16-bit add with carry 

16-bit subtract with carry 

Rotate accumulator 

Rotate and shift location m 


14 
o< 
<-> 


ovrowvoerecew e@ econo 
7 @e vr Owe VP Se oS 
we< <e<<0vdU << 
efevcrvc @C YH Oo 
oor ocr OC 8O 
CoOoxy KK ORO, 


SLA m; SRA m; SRL m 


RLD, RRD 


DAA 
CPL 
SCF 
CCF 


IN 1, (C) 

INI; IND; OUTI; OUTD 
INIR; INDR; OTIR; OTDR 
LDI, LDD 

LDIR, LDDR 

CPI, CPIR, CPD, CPDR 


LDA,I;LDA,R 


BIT b,s 
NEG 


Rotate digit left and right 

Decimal adjust accumulator 

Complement accumulator 

Set carry 

Complement carry 

Input register indirect 

Block input and output 

Z = 0 if B #0 otherwise Z = 1 

Block transfer instructions 

P/V = 1 if BC #0, otherwise P/V =0 

Block search instructions 
Z=1 if A=(HL), otherwise Z = 0 
P/V = 1 if BC #0, otherwise P/V = 0 

The content of the interrupt enable flip-flop (IFF) 
is copied into the P/V flag 

X| X} 0 The state of bit b of location s is copied into the Z flag 


@eeoeeoeeervrreeoevrv @ 
Pa Pn ee a ee en ee 
oooh Mme ee UU 
Seat Se Me eo 
—- OOK COCO 6 OS 
x~Coox* KOKORO 


“Ti 
“Ti 
<> 


vitli Negate accumulator 


The following notation is used in this table: 


Symbol 


C 
Z 
S 


wee Ceo 


nan m= 
Rn 


3 : 
BS 7E 


3 


Operation 


Carry/link flag. C=1 if the operation produced a carry from the MSB of the operand or result. 
Zero flag. Z=1 if the result of the operation is zero. 
Sign flag. S=1 if the MSB of the result is one. 


Parity or overflow flag. Parity (P) and overflow (V) share the same flag. Logical operations affect this flag 
with the parity of the result while arithmetic operations affect this flag with the overflow of the result. If P/V 
holds parity, P/V=1 if the result of the operation is even, P/V=0 if result is odd. If P/V holds overflow, P/V=1 
if the result of the operation produced an overflow. 


Half-carry flag. H=1 if the add or subtract operation produced a carry into or borrow from into bit 4 of the accumulator. 
Add/Subtract flag. N=1 if the previous operation was a subtract. 


H and N flags are used in conjunction with the decimal adjust instruction (DAA) to properly correct the re- 
sult into packed BCD format following addition or subtraction using operands with packed BCD format. 


The flag is affected according to the result of the operation. 

The flag is unchanged by the operation. 

The flag is reset by the operation. 

The flag is set by the operation. 

The flag is a ‘‘don’t care.” 

P/V flag affected according to the overflow result of the operation. 
P/V flag affected according to the parity result of the operation. 


Any one of the CPU registers A, B, C, D, E, H, L. 

Any &-bit location for all the addressing modes allowed for the particular instruction. . 
Any 16-bit location for all the addressing modes allowed for that instruction. 

Any one of the two index registers IX or IY. 

Refresh counter. 

8-bit value in range <O, 255> 


16-bit value in range <0, 65535> 
Any 8-bit location for all the addressing modes allowed for the particular instruction. 
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Table A-45. Summary of Z80 Restart Instructions 


Cc 
A 
L 
L 
A 
D 
D 
R 
E 
S 
$ 
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Table A-46. Summary of the Z80 Assembler 


ASSEMBLER FIELD STRUCTURE 


The assembly language instructions have the standard field structure (see Table 
2-1). The required delimiters are: 


1) A colon after a label, except for the pseudo-operations EQU, DEFL, and 
MACRO, which require a space. 

2) A space after the operation code. 

3) A comma between operands in the operand field. (Remember this one!) 

4) A semicolon before a comment. 

5) Parentheses around memory references. 


LABELS 


The assembler allows six characters in labels; the first character must be a letter, 
while subsequent characters must be letters, numbers, ?, or the underbar 
character (_). We will use only capital letters or numbers, although some versions 
of the assembler allow lower-case letters and other symbols. 


RESERVED NAMES 


Some names are reserved as keywords and should not be used by the program- 
mer. These are the register names (A, B, C, D, E, H, L, |, R), the double register 
names (IX, lY, SP), the register names (AF, BC, DE, HL, AF’, BC’, DE’, HL’), and 
the states of the four testable flags (C, NC, Z, NZ, M, P, PE, PO). 


PSEUDO-OPERATIONS 


The assembler has the following basic pseudo-operations: 


DEFBorDB - DEFINE BYTE 
DEFL ” DEFINE LABEL 
DEFM - DEFINE STRING 
DEFSorDS - DEFINE STORAGE 
DEFW or DW - DEFINE WORD 
END - END 

EQU - EQUATE 

ORG - ORIGIN 


ADDRESSES 


The Zilog Z80 assembler allows entries in the address field in any 
of the following forms: 


1) Decimal (the default case) 
Example: 1247 


2) Hexadecimal (must start with a digit and end with an H) 
Examples’ 142CH. OE7H 

3) Octal (must end with O or OQ, but Q is far less confusing) 
Example: 12470 or 12470 


4) Binary (must end with B) 
Example: 1001001000111B 

5) ASCII (enclosed in single quotation marks) 
Example: ‘HERE’ 


6) As an offset from the Program Counter ($) 
Example: $+237H 


Aocencdcix 8 Programming 
Reference forthe 
Z80 PIO Device 


D2 
D7 
D6 
CE 

C/D SEL 


Pin Name 
DO0-D7 
CE_ 

B/A SEL 
C/D SEL 
MI 


TORQ 
RD 
A0-A7 
A RDY 
A STB 
BO-B7 
B RDY 
B STB 
IEI 
IEO 
INT 


@, +5V,GND 


Figure B-4. PIO pin assignments 


] 
2 
3 
4 
5 
6 
7 
8 
9 


Description 


Data Bus 

Device Enable 

Select Port A or Port B 

Select Control or Data 

Instruction fetch machine 
cycle signal from CPU 

Input/Output request from CPU 

Read cycle status from CPU 

Port A Bus 

Register A Ready 

Port A strobe pulse 

Port B Bus 

Register B Ready 

Port B strobe pulse 

Interrupt enable in 

Interrupt enable out 

Interrupt request 

Clock, Power, and Ground 


Tristate, Bidirectional 
Input 
Input 
Input 
Input 


Input 

Input 

Tristate, Bidirectional 
Output 

Input 

Tristate, Bidirectional 
Output 

Input 

Input 

Output 

Output, Open-drain 
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+5V GND © 


Data or 


Internal Control 
Control 
Logic 
8 Handshake 
CPU . 
Bus Internal Bus Peripheral 
Intertace 6 I/O Interface 


CPU Data Bus! 


Data or 


PIO Control 
Lines Interrupt Control 
Control 
3 


\ Handshake 


Interrupt Control Lines 





Figure B-2. Block diagram of the PIO 


Mode Control Input/Output 
Reg Select Reg 


(2 Bits) (8 Bits) 
Output Enable 
Data 
Output 


Reg 
Internal Bus (8 Bits) 


8-Bit Peripheral 
Data or Control Bus 


Mask Data 
Control Input 
Reg : Reg 
(2 Bits) (8 Bits) 

Input Data 


Control STROBE 
Logic 


Lines 


Interrupt Handshake ; Handshake 


Requests 





Figure B-3. Block diagram of PIO port I/O 
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Register Selection 


Select Lines 


B/ 


Register Selected 


A Data 
B Data 
A Control 
B Control 


Mode Control Word Interrupt Control Word 


CEE Ses Pa Des] e[ 


D, 
——’ 


Dy} Ds 
ee ee 
| { Identifies mode control word eae interrupt 
Don’t care control word 
Mode select No mask word follows 


0 0 Mode 0 Output Mask word follows 
0 1 Mode | Input 

1 0 Mode 2 Bidirectional 
1 1 Mode 3 Bit Control 





0 

] 

0 Active level is low 
1 Active level is high 
0 
1 
0 


a A 


Interrupt on OR function 
Interrupt on AND function 





nn 


| 


OU 00 OD 


Interrupt disabled 
1 Interrupt enabled* 


ee) 


*Note: The Port is not enabled until the interrupt enable 
is followed by an active M1. 


Interrupt Vector Word Mask Control Word 


Pr] P.[Ps] Pu} Ps] 2], 0 


Identifies interrupt 
vector MB,-MB, mask bits. A 
User-supplied interrupt bit is monitored for an 


Interrupt if it is defined 
as an input and the mask 
bit is set to 0. 





vector 


I/O Register Control Word Interrupt Disable Word 
P,[P.1s]>.] 0] 2] 1] | 
ee anne 

—namnnnennnnnneereene() sets bit to output Te cee interrupt 


1 sets bit to input disable word 





Don’t care 





= Q Interrupt disable 
1 Interrupt enable 





Figure B-4, Programming summary for the PIO 
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CONTEST 0d 


Output When selecting Mode 3, the next byte must 
Input set the I/O Register: 
Bidirectional 


Bi trol 
it Contro 1/O7|1/O6{1/O5|1/04)1/03}1/O2}1/01]1/00 


I/O= 1 Sets bit to input 
I/O = 0 Sets bit to output 


PIO Mode Control Word 


(Binary) (Hex) 
Output OOOOIII! OF 
Input O1OOIII1 4F 
Bidirectional | lOOOI111 8F 
Control 11001111 CF 


Note that bits 4 and 5 are not used and 
could have any values. 





Figure B-5. Mode control for the PIO 


7 6 5 4 3 2 41 #0 <@—Bit no. 


fe HE ilhee ew thle ail se Command byte 


a vector specified 


Output these eight bits when 
an interrupt request is acknowledged 





Figure B-6. Interrupt vector loading format for the PIO 
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0 <#——Bit no. 


See CL ke contro code 


SOS eee eee” 


_—_ select code 


Don’t care 


00 Output, mode 0 

01 Input, mode | 

10 Bidirectional, mode 2 
11 Control, mode 3 





Figure B-7. Mode selection format for the PIO 


3: 2 1 _0 ~<t— Bit no. 


Control code 


AAA ne 
{ Interrupt enable control 


Don’t care 


0 Disable interrupts 
1 Enable interrupts 





Figure B-8. Interrupt enable/disable format for the PIO 
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{ Interrupt control word 


1 if interrupt select mask follows 
0 otherwise 


1 high input on selected pins is active 
0 low input on selected pins is active 


1 AND selected pins for interrupt 
0 OR selected pins for interrupt 


1 Enable interrupts 
0 Disable interrupts 





Figure B-9. Interrupt condition-setting format for the PIO 
(mode 3 only) 


Table B-4. PIO Select Logic Table B-2. Addressing of PIO Control Registers 


—— — — Selected Location | 

CE B/A SEL|C/D SEL Mode control D,= D,=D,= Dy= l 
| Pree ee Next byte after mode control 
Port A control buffer 


sets mode 3 
Port B data buffer 


D, = 0, D, = D,= Dj = 1 
Port B control buffer Next byte after mask control 
Device not selected 































Input/Output control 


















Mask control register 


Interrupt mask register 











register accessed with D, = 1 
D,= D,=0,D,=D)= ! 
D)= 1 






Interrupt enable 


Interrupt vector 


Aopenaix C ASCII Character 


Set 


“ONT “WALYANAS NOISSIN Udd AG GALNINdda 
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Glossary 


A 


Absolute address. An address that identifies a storage location or an I/O device 
without the use of a base, offset, or other factor. See also Effective address, Relative 
offset. 


Absolute addressing. An addressing mode in which the instruction contains the actual 
address required for its execution, as opposed to modes in which the instruction 
contains a relative offset or identifies a base register. 


Accumulator. A register that is the implied source of one operand and the destination 
of the result in most arithmetic and logical operations. 


Active transition. The edge ona strobe line that sets an indicator. The alternatives area 
negative edge (1 to 0 transition) or a positive edge (0 to | transition). 


Address. The identification code that distinguishes one memory location or I/O port 
from another and that can be used to select a specific one. 


Addressing mode. The method for specifying the addresses to be used in executing an 
instruction. Common addressing modes are direct, immediate, indexed, indirect, 
and relative. 


Address register. A register that contains a memory address. 
Address space. The total range of addresses to which a particular computer may refer. 
ALU. See Arithmetic-logic unit. 


Arithmetic-logic unit (ALU). A device that can perform a variety of arithmetic and 
logical functions; function inputs select which one the device performs during a 
particular cycle. 
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Arithmetic shift. A shift operation that keeps the sign (most significant) bit the same. 
In a right shift, this results in copies of the sign bit moving right (called sign 
extension). 


Arm. Usually refers specifically to interrupts. See Enable. 


Array. A collection of related data items, usually stored in consecutive memory 
addresses. 


ASCII (American Standard Code for Information Interchange). A 7-bit character 
code widely used in computers and communications. 


Assembler. A computer program that converts assembly language programs into a 
form (machine language) that the computer can execute directly. The assembler 
translates mnemonic operation codes and names into their numerical equivalents 
and assigns locations in memory to data and instructions. 


Assembly language. A computer language in which the programmer can use mne- 
monic operation codes, labels, and names to refer to their numerical equivalents. 


Asynchronous. Operating without reference to an overall timing source, that is, at 
irregular intervals. 


Autodecrementing. The automatic decrementing of an address register as part of the 
execution of an instruction that uses it. 


Autoincrementing. The automatic incrementing of an address register as part of the 
execution of an instruction that uses it. 


Automatic mode (of a peripheral chip). An operating mode in which the peripheral 
chip produces control signals automatically without specific program intervention. 


Base address. The address in memory at which an array or table starts. Also called 
starting address or base. 


Baud. A measure of the rate at which serial data is transmitted; bits per second, 
including both data bits and bits used for synchronization, error checking, and other 
purposes. Common baud rates are 110, 300, 1200, 2400, 4800, 9600, and 19,200. 


Baud rate generator. A device that generates the proper time intervals between bits for 
serial data transmission. 


BCD (Binary-Coded Decimal). A representation of decimal numbers in which each 
decimal digit is coded separately into a binary number. 


Bidirectional. Capable of transporting signals in either direction. 
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Binary-coded decimal. See BCD. 


Binary search. A search method that divides the set of items to be searched into two 
equal (or nearly equal) parts in each iteration. The part containing the item being 
sought is determined and then used as the set in the next iteration. Each iteration ofa 
binary search thus halves the size of the set being searched. This method obviously 
assumes an ordered set of items. 


BIOS (Basic Input/Output System). The part of CP/M that allows the operating 
system to use the I/O devices for a particular computer. The computer manufacturer 
or dealer typically supplies the BIOS; Digital Research, the originator of CP/M, 
provides only a sample BIOS with comments. 


Bit test. An operation that determines whether a bit is 0 or 1. Usually refers to a logical 
AND operation with an appropriate mask. 


Block. An entire group or section, such as a set of registers or a section of memory. 


Block comparison (or block compare). A search that extends through a block of 
memory until either the item being sought is found or the entire block is examined. 


Block move. Moving an entire set of data from one area of memory to another. 
Block search. See Block comparison. 


Boolean variable. A variable that has only two possible values, which may be repre- 
sented as true and false or as | and 0. See also Flag. 


Borrow. A bit that is set to 1 if a subtraction produces a negative result and to 0 if it 
produces a positive or zero result. The borrow is commonly used to subtract num- 
bers that are too long to be handled in a single operation. 


Bounce. Move back and forth between states before reaching a final state. Usually 
refers to mechanical switches that do not open or close cleanly, but rather move back 
and forth between positions for a while before settling down. 


Branch instruction. See Jump instruction. 


Breakpoint. A condition specified by the user under which program execution is to end 
temporarily, used as an aid in debugging programs. The specification of the condi- 
tions under which execution will end is referred to as setting breakpoints, and the 
deactivation of those conditions is referred to as clearing breakpoints. 


BSC (Binary Synchronous Communications or Bisync). An older line protocol often 
used by IBM computers and terminals. 


Bubble sort. A sorting technique that works through the elements of an array consecu- 
tively, exchanging an element with its successor if they are out of order. 
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Buffer. Temporary storage area generally used to hold data before they are transferred 
to their final destinations. 


Buffer empty. A signal that is active when all data entered into a buffer or register have 
been transferred to their final destinations. 


Buffer full. A signal that is active when a buffer or register is completely occupied with 
data that have not been transferred to their final destinations. 


Buffer index, The index of the next available address in a buffer. 
Buffer pointer. A storage location that contains the next available address in a buffer. 
Bug. An error or flaw in a program. 


Byte. A unit of eight bits. May be described as consisting of a high nibble or digit (the 
four most significant bits) and a low nibble or digit (the four least significant bits). 


Byte-length. A length of eight bits per item. 


Cc 


Call (a subroutine). Transfer control to a subroutine while retaining the information 
required to resume the current program. A call differs from a jump or branch in that 
a call remembers the previous position in the program, whereas a jump or branch 
does not. 


Carry. A bit that is | if an addition overflows into the succeeding digit position. 


Carry flag. A flag that is | if the last operation generated a carry from the most sig- 
nificant bit and 0 if it did not. 


CASE statement. A statement in a high-level computer language that directs the 
computer to perform one of several subprograms, depending on the value of a 
variable. That is, the computer performs the first subprogram if the variable has the 
first value specified, and so on. The computed GO TO statement serves a similar 
function in FORTRAN. 


Central processing unit (CPU). The control section of the computer; the part that 
controls its operations, fetches and executes instructions, and performs arithmetic 
_and logical functions. 


Checksum. A logical sum that is included in a block of data to guard against recording 
or transmission errors. Also referred to as longitudinal parity or longitudinal 
redundancy check (LRC). 


Circular shift. See Rotate. 
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Cleaning the stack. Removing unwanted items from the stack, usually by adjusting the 
stack pointer. 


Clear. Set to zero. 
Clock. A regular timing signal that governs transitions in a system. 


Close (a file). To make a file inactive. The final contents of the file are the last 
information the user stored in it. The user must generally close a file after working 
with it. 


Coding. Writing instructions in a computer language. 
Combo chip. See Multifunction device. 
Command register. See Control register. 


Comment. A section of a program that has no function other than documentation. 
Comments are neither translated nor executed, but are simply copied into the 
program listing. 


Complement. Invert; see also One’s complement, Two’s complement. 


Concatenation. Linking together, chaining, or uniting ina series. In string operations, 
concatenation refers to the placing of one string after another. 


Condition code. See Flag. 


Control (or command) register. A register whose contents determine the state of a 
transfer or the operating mode of a device. 


CP/M (Control Program/ Microcomputer). A widely used disk operating system for 
Z80-based computers developed by Digital Research (Pacific Grove, CA). 


CTC (Clock/ Timer Circuit). A programmable timer chip in the Z80 family. A CTC 
contains four 8-bit timers, range controls (prescalers), and other circuits. 


Cyclic redundancy check (CRC). An error-detecting code generated from a poly- 
nomial that can be added to a block of data or a storage area. 


Data accepted. A signal that is active when the most recent data have been transferred 
successfully. 


Data direction register. A register that determines whether bidirectional I/O lines are 
being used as inputs or outputs. 


Data-link control. Conventions governing the format and timing of data exchange 
between communicating systems. Also called a protocol. 
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Data-link controller. A chip that performs all or most of the functions required by a 
data-link control. The SIO is a data-link controller in the Z80 family. 


Data ready. A signal that is active when new data are available to the receiver. Same as 
valid data. 


DDCMP (Digital Data Communications Message Protocol). A protocol that sup- 
ports any method of physical data transfer (synchronous or asynchronous, serial or 
parallel). 


Debounce. Convert the output from a contact with bounce into a single clean transi- 
tion between states. Debouncing is most commonly applied to outputs from 
mechanical keys or switches that bounce back and forth before settling into their 
final positions. 


Debounce time. The amount of time required to debounce a change of state. 


Debugger. A systems program that helps users locate and correct errors in their 
programs. Some versions are referred to as dynamic debugging tools, or DDTs after 
the famous insecticide. Popular CP/M debuggers are SID (Symbolic Instruction 
Debugger) and ZSID (Z80 Symbolic Instruction Debugger) from Digital Research. 


Debugging. Locating and correcting errors in a program. 

Device address. The address of a port associated with an I/O device. 

Diagnostic. A program that checks the operation of a device and reports its findings. 
Digit shift. A shift of one BCD digit position or four bit positions. 


Direct addressing. An addressing mode in which the instruction contains the address 
required for its execution. Note that the standard Z80 assembler requires paren- 
theses around an address that is to be used directly. 


Disable (or disarm). Prevent an activity from proceeding or a signal (such as an 
interrupt) from being recognized. 


Disarm. Usually refers specifically to interrupts. See Disable. 
Double word. When dealing with microprocessors, a unit of 32 bits. 
Driver. See 1/O driver. 


Dump. A facility that displays the contents of an entire section of memory or group of 
registers on an output device. 


Dynamic allocation (of memory). The allocation of memory for a subprogram from 
whatever is available when the subprogram is called. An alternative is static alloca- 
tion of a fixed area of storage to each subprogram. Dynamic allocation often 
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reduces overall memory usage because subprograms can share areas; it does, 
however, generally require additional execution time and overhead spent in memory 
management. 


EBCDIC (Expanded Binary-Coded Decimal Interchange Code). An 8-bit character 
code often used in large computers. 


Echo. Reflect transmitted information back to the transmitter; send back to a terminal 
the information received from it. 


Editor. A program that manipulates text material and allows the user to make 
corrections, additions, deletions, and other changes. A popular CP/M editor is ED 
from Digital Research. 


Effective address. The actual address used by an instruction to fetch or store data. 
ETA RS-232. See RS-232. 


Enable (or arm). Allow an activity to proceed or a signal (such as an interrupt) to be 
recognized. 


Endless loop or jump-to-self instruction. An instruction that transfers control to itself, 
thus executing indefinitely (or until a hardware signal interrupts it). 


Error-correcting code. A code that the receiver can use to correct errors in messages; 
the code itself does not contain any additional message. 


Error-detecting code. A code that the receiver can use to detect errors in messages; the 
code itself does not contain any additional message. 


Even parity. A 1-bit error-detecting code that makes the total number of | bits in a unit 
of data (including the parity bit) even. 


EXCLUSIVE OR function. A logical function that is true if either, but not both, of its 
inputs is true. It is thus true if its inputs are not equal (that is, if one of them is a logic 
1 and the other is a logic 0). 


Extend (a number). Add digits to a number to conform to a format without changing 
its value. For example, one may extend an 8-bit unsigned result with zeros to fill a 
16-bit word. 


External reference. The use in a program of a name that is defined in another program. 


F register. See Flag register. 
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Field. A set of one or more positions within a larger unit, such as a byte, word, or 
record. 


File. A collection of related information that is treated as a unit for purposes of storage 
or retrieval. 


Fill. Placing values in storage areas not previously in use, initializing memory or 
storage. 


Flag (or condition code or status bit). A single bit that indicates a condition within the 
computer, often used to choose between alternative instruction sequences. 


Flag (software). An indicator that is either on or off and can be used to select between 
two alternative courses of action. Boolean variable and semaphore are other terms 
with the same meaning. 


Flag register. A Z80 register that holds all the flags. Also called the (processor) status 
register. 


Free-running mode. An operating mode for a timer in which it indicates the end of a 
time interval and then starts another of the same length. Also called a continuous 
mode. 


Function key. A key that causes a system to execute a procedure or perform a function 
(such as clearing the screen of a video terminal). 


G 


Global variable. A variable that is used in more than one section of a computer pro- 
gram rather than only locally. 


Handshake. An asynchronous transfer in which sender and receiver exchange signals 
to establish synchronization and to indicate the status of the data transfer. Typically, 
the sender indicates that new data are available and the receiver reads the data and 
indicates that it is ready for more. 


Hardware stack. A stack that the computer manages automatically when executing 
instructions that use it. 


Head (of a queue). The location of the item most recently entered into a queue. 
Header, queue. See Queue header. 


Hexadecimal (or hex). Number system with base 16. The digits are the decimal 
numbers 0 through 9, followed by the letters A through F (representing 10 through 
15 decimal). 
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Hex code. See Object code. 


High-level language. A programming language that is aimed toward the solution of 
problems, rather than being designed for convenient conversion into computer 
instructions. A compiler or interpreter translates a program written in a high-level 
language into a form that the computer can execute. Common high-level languages 
include Ada, BASIC, C, COBOL, FORTRAN, and Pascal. 


Immediate addressing. An addressing mode in which the data required by an instruc- 
tion are part of the instruction. The data immediately follow the operation code in 
memory. 


Index. A data item used to identify a particular element of an array or table. 


Indexed addressing. An addressing mode in which the address is modified by the 
contents of an index register to determine the effective address (the actual address 
used). 


Indexed indirect addressing. See Preindexing. 
Index register. A register that can be used to modify memory addresses. 


Indirect addressing. An addressing mode in which the effective address is the contents 
of the address included in the instruction, rather than the address itself. 


Indirect indexed addressing. See Postindexing. 


Indirect jump. A jump instruction that transfers control to the address stored in a 
register or memory location rather than to a fixed address. 


Input/ output control block (IOCB). A group of storage locations that contains the 
information required to control the operation of an I/O device. Typically included 
in the information are the addresses of routines that perform operations such as 
transferring a single unit of data or determining device status. 


Input/output control system (IOCS). A set of computer routines that controls the 
performance of I/O operations. 


Instruction. A group of bits that defines a computer operation and is part of the 
instruction set. 


Instruction cycle. The process of fetching, decoding, and executing an instruction. 


Instruction execution time. The time required to fetch, decode, and execute an 
instruction. 
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Instruction fetch. The process of addressing memory and reading an instruction into 
the CPU for decoding and execution. 


Instruction length. The amount of memory needed to store a complete instruction. 


Instruction set. The set of general-purpose instructions available on a given computer; 
the set of inputs to which the CPU will produce a known response when they are 
fetched, decoded, and executed. 


Interpolation. Estimating values of a function at points between those at which the 
values are already known. 


Interrupt. A signal that temporarily suspends the computer’s normal sequence of 
operations and transfers control to a special routine. 


Interrupt-driven. Dependent on interrupts for its operation; may idle until it receives 
an interrupt. 


Interrupt flag. A bit in the input/output section that is set when an event occurs that 
requires servicing by the CPU. Typical events include an active transition on a 
control line and the exhaustion of a count by a timer. 


Interrupt mask (or interrupt enable). A bit that determines whether interrupts will be 
recognized. A mask or disable bit must be cleared to allow interrupts, whereas an 
enable bit must be set. 


Interrupt request. A signal that is active when a peripheral is requesting service, often 
used to cause a CPU interrupt. See also Interrupt flag. 


Interrupt service routine. A program that performs the actions required to respond to 
an interrupt. 


Interrupt vector. An address to which an interrupt directs the computer, usually the 
starting address of a service routine. 


Inverted borrow. A bit that is set to 0 if a subtraction produces a negative result and to 
1 if it produces a positive or 0 result. An inverted borrow can be used like a true 
borrow, except that the complement of its value (i.e., 1 minus its value) must be used 
in the extension to longer numbers. 


IOCB. See Input/ output control block. 
IOCS. See Input/ output control system. 


I/O device table. A table that establishes the correspondence between the logical 
devices to which programs refer and the physical devices that are actually used in 
data transfers. An I/O device table must be placed in memory in order to run a 
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program that refers to logical devices on a computer with a particular set of actual 
(physical) devices. The I/O device table may, for example, contain the starting 
addresses of the I/O drivers that handle the various devices. 


I/O driver. A computer program that transfers data to or from an I/O device, also 
called a driver or I/ O utility. The driver must perform initialization functions and 
handle status and control, as well as physically transfer the actual data. 


Isolated input/output. An addressing method for I/O ports that uses a decoding 
system distinct from that used by the memory section. I/O ports thus do not occupy 
memory addresses. 


J 


Jump instruction (or branch instruction). An instruction that places a new value in the 
program counter, thus departing from the normal one-step incrementing. Jump 
instructions may be conditional; that is, the new value may be placed in the program 
counter only if a condition holds. 


Jump table. A table consisting of the starting addresses of executable routines, used to 
transfer control to one of them. 


L 


Label. A name attached to an instruction or statement in a program that identifies the 
location in memory of the machine language code or assignment produced from 
that instruction or statement. 


Latch. A device that retains its contents until new data are specifically entered into it. 
Leading edge (of a binary pulse). The edge that marks the beginning of a pulse. 


Least significant bit. The rightmost bit in a group of bits, that is, bit 0 of a byte or a 
16-bit word. 


Library program. A program that is part of a collection of programs and is written and 
documented according to a standard format. 


LIFO (last-in, first-out) memory. A memory that is organized according to the order in 
which elements are entered and from which elements can be retrieved only in the 
order opposite of that in which they were entered. See also Stack. 


Linearization. The mathematical approximation of a function by a straight line 
between two points at which its values are known. 


Linked list. A list in which each item contains a pointer (or /ink) to the next item. Also 
called a chain or chained list. 


476 2280 ASSEMBLY LANGUAGE SUBROUTINES 


List. An ordered set of items. 


Logical device. The input or output device to which a program refers. The actual or 
physical device is determined by looking up the logical device in an I/O device table 
—a table containing actual I/O addresses (or starting addresses for I/O drivers) 
corresponding to the logical device numbers. 


Logical shift. A shift operation that moves zeros in at either end as the original data are 
shifted. 


Logical sum. A binary sum with no carries between bit positions. See also Checksum, 
EXCLUSIVE OR function. 


Longitudinal parity. See Checksum. 
Longitudinal redundancy check (LRC). See Checksum. 


Lookup table. An array of data organized so that the answer to a problem may be 
determined merely by selecting the correct entry (without any calculations). 


Low-level language. A computer language in which each statement is translated 
directly into a single machine language instruction. 


Machine language. The programming language that the computer can execute directly 
with no translation other than numeric conversions. 


Maintenance (of programs). Updating and correcting computer programs that are in 
use. 


Majority logic. A combinational logic function that is true when more than half the 
inputs are true. 


Mark. The | state on a serial data communications line. 
Mask. A bit pattern that isolates one or more bits from a group of bits. 
Maskable interrupt. An interrupt that the system can disable. 


Memory capacity. The total number of different memory addresses (usually specified 
in bytes) that can be attached to a particular computer. 


Memory-mapped I/O. An addressing method for I/O ports that uses the same 
decoding system used by the memory section. The I/O ports thus occupy memory 
addresses. 


Microcomputer. A computer that has a microprocessor as its central processing unit. 
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Microprocessor. A complete central processing unit for a computer constructed from 
one or a few integrated circuits. 


Mnemonic. A memory jogger, a name that suggests the actual meaning or purpose of 
the object to which it refers. 


Modem (Modulator/demodulator). A device that adds or removes a carrier 
frequency, thereby allowing data to be transmitted on a high-frequency channel or 
received from such a channel. 


Modular programming. A programming method whereby the overall program is 
divided into logically separate sections or modules. 


Module. A part or section of a program. 


Monitor. A program that allows the computer user to enter programs and data, run 
programs, examine the contents of the computer’s memory and registers, and utilize 
the computer's peripherals. See also Operating system. 


Most significant bit. The leftmost bit in a group of bits, that is, bit 7 of a byte or bit 15 of 
a 16-bit word. 


Multifunction device. A device that performs more than one function in a computer 
system; the term commonly refers to devices containing memory, input/output 
ports, timers, and so forth. 


Multitasking. Executing many tasks during a single period of time, usually by working 
on each one fora specified part of the period and suspending tasks that must wait for 
input, output, the completion of other tasks, or external events. 


Murphy's Law. The famous maxim that “whatever can go wrong, will.” 


Negate. Find the two’s complement (negative) of a number. 

Negative edge (of a binary pulse). A 1-to-0 transition. 

Negative flag. See Sign flag. 

Negative logic. Circuitry in which a logic zero is the active or ON state. 


Nesting. Constructing programs in a hierarchical manner with one level contained 
within another. The nesting level is the number of transfers of control required to 
reach a particular part of a program without ever returning to a higher level. 


Nibble. A unit of four bits. A byte (eight bits) may be described as consisting of a high 
nibble (four most significant bits) and a low nibble (four least significant bits). 
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Nine’s complement. The result of subtracting a decimal number from a number having 
nines in all digit positions. 


Non-maskable interrupt. An interrupt that cannot be disabled within the CPU. 
Non-volatile memory. A memory that retains its contents when power is removed. 


Nop (or no operation). An instruction that does nothing except increment the 
program counter. 


Normalization (of numbers). Adjusting a number into a regular or standard format. A 
typical example is the scaling of a binary fraction to make its most significant bit 1. 


oO 


Object code (or object program). The program that is the output of a translator 
program, such as an assembler—usually a machine language program ready for 
execution. 


Odd parity. A 1-bit error-detecting code that makes the total number of | bits ina unit 
of data (including the parity bit) odd. 


One’s complement. A bit-by-bit logical complement of a number, obtained by replac- 
ing each 0 bit with a | and each | bit with a 0. 


One-shot. A device that produces a pulse output of known duration in response to a 
pulse input. A timer operates in a one-shot mode when it indicates the end of a single 
interval of known duration. 


Open (a file). Make a file ready for use. The user generally must open a file before 
working with it. 


Operating system (OS). A computer program that controls the overall operations of a 
computer and performs such functions as assigning places in memory to programs 
and data, scheduling the execution of programs, processing interrupts, and control- 
ling the overall input/output system. Also known as a monitor, executive, or 
master-control program, although the term monitor 1s usually reserved for a simple 
operating system with limited functions. 


Operation code (op code). The part of an instruction that specifies the operation to be 
performed. 


OS. See Operating system. 
Overflow (of a stack). Exceeding the amount of memory allocated to a stack. 


Overflow, two’s complement. See Two’s complement overflow. 
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P 


Packed decimal. A binary-coded decimal format in which each byte contains two 
decimal digits. 


Page. A subdivision of the memory. In byte-oriented computers, a page is generally a 
256-byte section of memory in which all addresses have the same eight most 
significant bits (or page number). For example, page C6 would consist of memory 
addresses C600 through C6FF. 


Paged address. The identifier that characterizes a particular memory address on a 
known page. In byte-oriented computers, this is usually the eight least significant 
bits of a memory address. 


Page number. The identifier that characterizes a particular page of memory. In 
byte-oriented computers, this is usually the eight most significant bits of a memory 
address. 


Parallel interface. An interface between a CPU and input or output devices that handle 
data in parallel (more than one bit at a time). The PIO is a parallel interface in the 
Z80 family. 


Parameter. An item that must be provided to a subroutine or program for it to be 
executed. 


Parity. A 1-bit error-detecting code that makes the total number of | bits in a unit of 
data, including the parity bit, odd (odd parity) or even (even parity). Also called 
vertical parity or vertical redundancy check (VRC). 


Passing parameters. Making the required parameters available to a subroutine. 
Peripheral ready. A signal that is active when a peripheral can accept more data. 


Physical device. An actual input or output device, as opposed to a logical device. 


PIO (Parallel Input/Output Device). A parallel interface chip in the Z80 family. A PIO 
contains two 8-bit I/O ports, four control lines, and other circuitry. 


Pointer. A storage place that contains the address of a data item rather than the item 
itself. A pointer tells where the item is located. 


Polling. Determining which I/O devices are ready by examining the status of one 
device at a time. 


Polling interrupt system. An interrupt system in which a program determines the 
source of a particular interrupt by examining the status of potential sources one at a 
time. 


Pop. Remove an operand from a stack. 
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Port. The basic addressable unit of the computer’s input/output section. 
Positive edge (of a binary pulse). A 0-to-1 transition. 

Postdecrementing. Decrementing an address register after using it. 
Postincrementing. Incrementing an address register after using it. 


Postindexing. Anaddressing mode in which the effective address is determined by first 
obtaining the base address indirectly and then indexing from that base address. The 
“post” refers to the fact that the indexing is performed after the indirection. 


Power fail interrupt. An interrupt that informs the CPU of an impending loss of power. 
Predecrementing. Decrementing an address register before using it. 
Preincrementing. Incrementing an address register before using it. 


Preindexing. An addressing mode in which the effective address is determined by 
indexing from the base address and then using the indexed address indirectly. The 
“pre” refers to the fact that the indexing is performed before the indirection. Of 
course, the array starting at the given base address must consist of addresses that can 
be used indirectly. 


Priority interrupt system. An interrupt system in which some interrupts have 
precedence over others; that is, they will be serviced first or can interrupt the others’ 
service routines. 


Program counter (PC register). A register that contains the address of the next 
instruction to be fetched from memory. 


Programmable I/O device. An I/O device that can have its mode of operation 
determined by loading registers under program control. 


Programmable peripheral chip (or programmable peripheral interface). A chip that 
can operate in a variety of modes; its current operating mode is determined by 
loading control registers under program control. 


Programmable timer. A device that can handle a variety of timing tasks, including the 
generation of delays, under program control. The CTC is a programmable timer in 
the Z80 family. 


Programmed input/output. Input or output performed under program control 
without using interrupts or other special hardware techniques. 


Program relative addressing. A form of relative addressing in which the base address 
is the program counter. Use of this form of addressing makes it easy to move 
programs from one place in memory to another. 


Protocol. See Data-link control. 
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Pseudo-operation (or pseudo-op or pseudo-instruction). An assembly language 
operation code that directs the assembler to perform some action but does not 
result in the generation of a machine language instruction. 


Pull. Remove an operand from a stack; same as pop. 


Push. Store an operand in a stack. 


Queue. A set of tasks, storage addresses, or other items that are used in a first-in, 
first-out manner; that is, the first item entered into the queue is the first to be used or 
removed. 


Queue header. A set of storage locations describing the current location and status of 
a queue. 


RAM. See Random-access memory. 


Random-access (read/write) memory (RAM). A memory that can be both read and 
altered (written) in normal operation. 


Read-only memory (ROM). A memory that can be read but not altered in normal 
operation. 


Ready for data. A signal that is active when the receiver can accept more data. 
Real-time. In synchronization with the actual occurrence of events. 
Real-time clock. A device that interrupts a CPU at regular time intervals. 


Real-time operating system. An operating system that can act as a supervisor for 
programs that have real-time requirements. May also be referred to as a real-time 
executive or real-time monitor. 


Reentrant. A program or routine that can be executed concurrently while the same 
routine is being interrupted or otherwise held in abeyance. 


Refresh. Rewriting data into a memory before its contents are lost. Dynamic RAM 
must be refreshed periodically (typically every few milliseconds) or it will lose its 
contents spontaneously. 


Register. A storage location inside the CPU. 


Register pair. In Z80 terminology, two 8-bit registers that can be referenced as a 16-bit 
unit. 
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Relative addressing. An addressing mode in which the address specified in the 
instruction is the offset from a base address. 


Relative offset. The difference between the actual address to be used in an instruction 
and the current value of the program counter. 


Relocatable. Can be placed anywhere in memory without changes; that is, a program 
that can occupy any set of consecutive memory addresses. 


Return (from a subroutine). Transfer control back to the program that originally 
called the subroutine and resume its execution. 


ROM. See Read-only memory. 


Rotate. A shift operation that treats the data as if they were arranged ina circle; that is, 
as if the most significant and least significant bits were connected either directly or 
through a Carry bit. 


Row major order. Storing elements of a multidimensional array in memory by 
changing the indexes starting with the rightmost first. For example, if a typical 
element is A(J,J,K) and the elements begin with A(0,0,0), the order is A(0,0,0), 
A(0,0,1),...,A(0,1,0), A(0,1,1),.... The opposite technique (changing the leftmost 
index first) is called column major order. 


RS-232 (or EIA RS-232). A standard interface for the transmission of digital data, 
sponsored by the Electronic Industries Association of Washington, D.C. It has been 
partially superseded by RS-449. 


Ss 


Scheduler. A program that determines when other programs should be started and 
terminated. 


Scratchpad. An area of memory that is generally easy and quick to use for storing 
variable data or intermediate results. 


SDLC. (Synchronous Data Link Control). The successor protocol to BSC for IBM 
computers and terminals. 


Semaphore. See Flag. 
Serial. One bit at a time. 


Serial interface. An interface between a CPU and input or output devices that handle 
data serially. The SIO is a popular serial interface chip in the Z80 family. See also 
UART. 


Setpoint. The value of a variable that a controller is expected to maintain. 
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Shift instruction. An instruction that moves all the bits of the data by a certain 
number of bit positions, just as in a shift register. 


Signed number. A number in which one or more bits represent whether the number is 
positive or negative. A common format is for the most significant bit to represent 
the sign (0 = positive, 1 = negative). 


Sign extension. The process of copying the sign (most significant) bit to the right as in 
an arithmetic shift. Sign extension preserves the sign when two’s complement 
numbers are being divided or normalized. 


Sign flag. A flag that contains the most significant bit of the result of the previous 
operation. It is sometimes called a negative flag, since a value of | indicates a 
negative signed number. 


Sign function. A function that is 0 if its parameter is positive and | if its parameter is 
negative. 


SIO (Serial Input/Output Device). A serial interface chip in the Z80 family. An SIO 
can be used as an asynchronous or synchronous serial interface (i.e.,as a UART or 
USRT) or as a data-link controller. 


Size (of an array dimension). The distance in memory between elements that are 
ordered consecutively in a particular dimension; the number of bytes between the 
starting address of an element and the starting address of the element with an index 
one larger in a particular dimension but the same in all other dimensions. 


Software delay. A program that has no function other than to waste time. 
Software interrupt. See Trap. 


Software stack. A stack that is managed by means of specific instructions, as opposed 
to a hardware stack which the computer manages automatically. 


Source code (or source program). A computer program written in assembly language 
or in a high-level language. 


Space. The zero state on a serial data communications line. 


Stack. A section of memory that can be accessed only in a last-in, first-out manner. 
That is, data can be added to or removed from the stack only through its top; new 
data are placed above the old data and the removal of a data item makes the item 
below it the new top. 


Stack pointer. A register that contains the address of the top of a stack. 


Standard (or 8,4,2,1 ) BCD. A BCD representation in which the bit positions have the 
same weight as in ordinary binary numbers. 
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Standard teletypewriter. A teletypewriter that operates asynchronously at a rate of 
ten characters per second. 


Start bit. A 1-bit signal that indicates the start of data transmission by an asynchro- 
nous device. 


Static allocation (of memory). Assignment of fixed storage areas for data and pro- 
grams; an alternative is dynamic allocation, in which storage areas are assigned 
when they are needed. 


Status register. A register whose contents indicate the current state or operating mode 
of a device. 


Status signal. A signal that describes the current state of a transfer or the operating 
mode of a device. 


Stop bit. A 1-bit signal that indicates the end of data transmission by an asynchro- 
nous device. 


String. An array (set of data) consisting of characters. 


String functions. Procedures that allow the programmer to operate on data consist- 
ing of characters rather than numbers. Typical functions are insertion, deletion, 
concatenation, search, and replacement. 


Strobe. A signal that identifies or describes another set of signals and can be used to 
control a buffer, latch, or register. 


Subroutine. A subprogram that can be executed (called) from more than one place in 
a main program. 


Subroutine call. The process whereby a computer transfers control from its current 
program to a subroutine while retaining the information required to resume the 
current program. 


Subroutine linkage. The mechanism whereby a computer retains the information 
required to resume its current program after it completes the execution of a 
subroutine. 


Suspend (a task). Halt execution and preserve the status of a task until some future 
time. 


Synchronization (or sync) character. A character that is used only to synchronize the 
transmitter and the receiver. 


Synchronous. Operating according to an overall timing source or clock, that is, at 
regular intervals. 


cLossary 485 


Systems software. Programs that perform administrative functions or aid in the 
development of other programs but do not actually perform any of the computer’s 
workload. 


T 


Tail (of a queue). The location of the oldest item in the queue, that is, the earliest 
entry. 


Task. A self-contained program that can serve as part of an overall system under the 
control of a supervisor. 


Task status. The set of parameters that specifies the current state of a task. A task can 
be suspended and resumed as long as its status is saved and restored. 


Teletypewriter. A device containing a keyboard and a serial printer that is often used in 
communications and with computers. Also referred to as a Teletype (a registered 
trademark of Teletype Corporation of Skokie, Illinois) or TTY. 


Ten’s complement. The result of subtracting a decimal number from zero (ignoring the 
minus sign); the nine’s complement plus one. 


Terminator. A data item that has no function other than to signify the end of an array. 


Threaded code. A program consisting of subroutines, each of which automatically 
transfers control to the next one upon its completion. 


Timeout. A period during which no activity is allowed to proceed; an inactive period. 


Top of the stack. The address containing the item most recently entered into the 
stack. 


Trace. A debugging aid that provides information about a program while the pro- 
gram is being executed. The trace usually prints all or some of the intermediate 
results. 


Trailing edge (of a binary pulse). The edge that marks the end of a pulse. 


Translate instruction. An instruction that converts its operand into the correspond- 
ing entry in a table. 


Transparent routine. A routine that operates without interfering with the operations 
of other routines. 


Trap (or software interrupt). An instruction that forces a jump to a specific (CPU- 
dependent) address, often used to produce breakpoints or to indicate hardware or 
software errors. 


True borrow. See Borrow. 
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True comparison. A comparison that finds the two operands to be equal. 


Two's complement. A binary number that, when added to the original number ina 
binary adder, produces a zero result. The two’s complement of a number may be 
obtained by subtracting the number from zero or by adding | to the one’s com- 
plement. 


Two's complement overflow. A situation in which a signed arithmetic operation 
produces a result that cannot be represented correctly; that is, the magnitude 
overflows into the sign bit. 


UART (Universal Asynchronous Receiver/ Transmitter). An LSI device that acts as 
an interface between systems that handle data in parallel and devices that handle 
data in asynchronous serial form. 


Underflow (of a stack). Attempting to remove more data from a stack than has been 
entered into it. 


Unsigned number. A number in which all the bits are used to represent magnitude. 


USART (Universal Synchronous/ Asynchronous Receiver/Transmitter). An LSI 
device (such as the SIO) that can serve as either a UART or a USRT. 


USRT (Universal Synchronous Receiver/ Transmitter). An LSI device that acts as an 
interface between systems that handle data in parallel and devices that handle data 
in synchronous serial form. 


Utility. A general-purpose program, usually supplied by the computer manufacturer 
or part of an operating system, that executes a standard or common operation such 
as sorting, converting data from one format to another, or copying a file. 


V 


Valid data. A signal that is active when new data are available to the receiver. 


Vectored interrupt. An interrupt that produces an identification code (or vector) that 
the CPU can use to transfer control to the appropriate service routine. The process 
whereby control is transferred to the service routine is called vectoring. 


Volatile memory. A memory that loses its contents when power is removed. 


Ww 


Walking bit test. A procedure whereby a single | bit is moved through each bit 
position in an area of memory and a check is made as to whether it can be read back 
correctly. 
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Word. The basic grouping of bits that a computer can process at one time. When 
dealing with microprocessors, the term often refers to a 16-bit unit of data. 


Word boundary. A boundary between 16-bit storage units containing two bytes of 
information. If information is being stored in word-length units, only pairs of bytes 
conforming to (aligned with) word boundaries contain valid information. Mis- 
aligned pairs of bytes contain one byte from one word and one byte from another. 


Word-length. A length of 16 bits per item. 


Wraparound. Organization in a circular manner as if the ends were connected. A 
storage area exhibits wraparound if operations on it act as if the boundary 
locations were contiguous. 


Write-only register. A register that the CPU can change but cannot read. Ifa program 
must determine the contents of such a register, it must save a copy of the data 
placed there. 


Z 


Zero flag. A flag that is | if the last operation produced a result of zero and 0 if it did 
not. 


Zoned decimal. A binary-coded decimal format in which each byte contains a single 
decimal digit. 
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A register. See Accumulator 
Abbreviations, recognition of, 289, 297, 298 
Absolute branches, 3-4 
Absolute value, 82-83, 84-85, 186, 222-23 
Accumulator (register A), 5, 6, 7, 8, 9 
clearing, 15 
decimal operations, 73, 74, 124 
decision sequences, 31 
functions, 5, 6, 7 
instructions, 7 
special features, 2, 8 
testing, 92 
Accumulator rotates, 3, 20, 23 
ADC, 42, 73-74 
decimal version, 73 
result, 42 
rotate (ADC A,A), 91 
ADC, 42, 73-74 
logical shifts (A, HL, xy), 23, 35, 89 
Addition 
BCD, 72, 73, 248-50 
binary, 16, 41-42, 72-74, 228-30 
decimal, 72, 73, 248-50 
8-bit, 16, 72, 73 
multiple-precision, 41-42, 228-30, 248-50 
16-bit, 72-73, 74 
Addition instructions 
with Carry, 42, 73-74 
without Carry, 16, 72-73 
Address addition, 3, 4, 33, 34 
Address arrays, 35, 39 
Address format in memory (upside-down), 5, 11 
Addressing modes, 10, 13 
arithmetic and logical instructions, 2 
autoindexing, 129-34 
default (immediate), 17, 149 
direct, 10-11, 13, 94, 95, 96, 97 
immediate, II, 95 
indexed, 3, 12, 14, 103, 127-29 
indirect, 2, 3, 11-12, 13, 94-95, 96-97, 126-27 
jump and call instructions, 148 
postindexed, 136-37 
preindexed, 134-36 
register, 2 
register indirect, 2 
Add/subtract (N) flag, ix, 74 
Adjust instructions, 124 
AF register pair, 12 
Aligning bit fields, 272 
Alternate (primed) registers, 4, 96, 97 


AND, 85-86 
clearing bits, 18, 19, 85 
masking, 268, 271 
testing bits, 18, 19 
Apostrophe indicating ASCII character, x 
Arithmetic 
BCD, 72-78, 248-66 
binary, 16-18, 72-80, 217-47 
decimal, 72-78, 248-66 
8-bit, 16-18, 72-80 
multiple-precision, 41-42, 228-66 
16-bit, 73-80, 217-27 
Arithmetic expressions, evaluation of, 132 
Arithmetic instructions, 72-84 
addressing modes, 2 
8-bit, 445, 446 
multiple operands, 16 
16-bit, 143, 447 
Arithmetic shift, 80, 89, 273-75 
Arrays, 33-38, 128-37, 319-55 
addresses, 39, 129-30, 131, 352-55 
initialization, 195-97 
manipulation, 33-38 
ASCII, 150, 463 
assembler notations, x 
control characters, 357 
conversions, 172-94 
table, 463 
ASCII to EBCDIC conversion, 189-91 
Assembler 
defaults, x, 149, 155, 455 
error recognition, 155-56 
format, x, 455 
pseudo-operations, x, 455 
summary, 455 
Autoindexing, 129-34 
Autopostdecrementing, 133-34 
Autopostincrementing, 130-31 
Autopredecrementing, 131-32 
Autopreincrementing, 129-30 
Auxiliary carry (AC) flag, ix. See also Half-carry 


B (indicating binary number), x 

B register, special features of, 5, 6, 9, 30, 32, 54 
Backspace, destructive, 362-63 

Base address of an array or table, 33-35, 38-39 
BC register pair, 5, 9, 12, 36 

BCD (decimal) arithmetic, 72-78, 248-66 

BCD representation, 150 

BCD to binary conversion, 170-71 
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BDOS calls (in CP/M), 359-63, 366-67, 379-84 
table, 357 
Bidirectional mode of PIO, 62 
Bidirectional ports, 61-62, 63-64, 158 
Binary search, 331-35 
Binary to BCD conversion, 167-69 
BIT, 18, 19, 93-94, 341 
Bit field extraction, 267-69 
Bit field insertion, 270-72 
Bit manipulation, 18-20, 85-87, 88, 93-94, 101, 
102, 267-72 
instructions, 449 
Block compare, 35-38, 288-91, 444 
flags, 37 
registers, 36, 37 
Block input/output instructions, 54-55, 452 
initialization, 385, 387 
limitations, 54 
registers, 54 
Block move, 35-38, 99, 198-200 
Block search, 444. See also Block compare 
Boolean algebra, 18-20 
Borrow, 27, 76 
Branch instructions, 24-31, 102-18, 450 
absolute branches, 3-4 
conditional branches, 104-18 
decision sequences, 31 
relative branches, 3-4, 32 
signed branches, 112-13 
unconditional branches, 102-04 
unsigned branches, 113-18 
Buffered interrupts, 413-24 
Byte shift, 181 


Cc 


C register, special use of, 6, 9, 54 

Calendar, 425-32 

Call instructions, 118-20, 451 

Carry (C) flag, 453 
adding to accumulator, 72 
arithmetic applications, 41-42 
borrow, 142 
branches, 27-28 
clearing, 101 
comparison instructions, 27-28, 142, 144 
decimal arithmetic, 72, 74 
decrement instructions (no effect), 4 
extending across accumulator, 84 
increment instructions (no effect), 4 
instructions affecting, 3, 453 
inverted borrow, 76, 142 
logical instructions, 3 
multiple-precision arithmetic, 41-42 
position in F register, ix, 434 
SBC, 42 


Carry (C) flag (continued) 
shifts, 3, 20 
subtracting from accumulator, 76 
subtraction, 42, 76 
Case statements, 39 
Character manipulation, 39-40. See also String 
manipulation 
Checksum, 87. See also Parity 
Circular shift (rotation), 20-22, 91-92, 282-87 
Cleaning the stack, 49-5] 
Clear instructions, 100-01 
Clearing accumulator, 100 
Clearing an array, 196-97, 258, 262 
Clearing bits, 18, 19, 85, 101 
Clearing flags, 86 
Clearing memory, 258, 262 
Clearing peripheral status, 61-62, 157, 158, 159, 
389, 399 
Clock interrupt, 425-32 
Code conversion, 40-41, 167-94 
Colon (delimiter after label), x 
Command register. See Control register 
Commands, execution of, 134 
Comment, x 
Common programming errors, 139-59 
interrupt service routines, 158-59 
I/O drivers, 156-58 
Communications between main program and 
interrupt service routines, 159, 394-95, 
413-14 
Communications reference, 369 
Compacting a string, 311 
Comparison instructions, 81-82 
bit-by-bit (logical EXCLUSIVE OR), 81 
Carry flag, 27, 144 
decimal, 266 
multiple-precision, 245-47 
operation, 26 
16-bit, 81-82, 225-27 
string, 288-91 
Zero flag, 26 
Complementing (inverting) bits, 18, 19, 20, 88 
Complementing the accumulator, 87-88 
Complement (logical NOT) instructions, 87-89 
Concatenation of strings, 292-96 
Condition code. See Flags; Status register 
Conditional call instructions, 120 
Conditional jump instructions, 104-18 
execution time (variable), 450 
Conditional return instructions, 120 
Control characters (ASCII), 357 
deletion, 362-63 
printing, 360 
Control register, 59-64, 157-58 
Control signal, 57-58 


Copying a substring, 302-07 
Conventions, 5 
CP, 26-29, 142, 144 
CPD, 36 
CPDR, 36 
CPI, 36, 40, 350 
CPIR, 36, 37, 40, 153 
CP/M operating system, 356-67, 379-84 
BDOS functions, 357 
buffer format, 367, 382 
string terminator, 359, 363 
CRC (cyclic redundancy check), 368-72 
CTC (clock/timer circuit), 388, 427-28 


DAA, 151 
Data direction (1/O control) register, 60 
Data structures, 44-46, 148-49, 414 
Data transfer instructions, 94-102, 142 
DB pseudo-operation, x 
DE register pair, special features of, 2, 5, 6, 9 
Debugging, 139-59 
interrupt service routines, 158-59 
I/O drivers, 156-58 
DEC, 4, 32 
differences between 8- and 16-bit versions, 4 
flags, 4 
Decimal (BCD) arithmetic, 151, 248-66 
addition, 248-50 
binary conversions, 167-71 
comparison, 266 
decrement by 1, 78, 124 
division, 260-65 
8-bit, 72-78 
increment by 1, 77, 124 
multibyte, 248-66 
multiplication, 254-59 
subtraction, 231-33 
validity check, 124 
Decimal default in assembler, 149, 150 
Decision sequences, 31 
Decrement instructions, 77-78 
decimal, 78, 124 
setting Carry, 78 
Defaults in assembler, x, 149, 155, 455 
DEFB pseudo-operation, x, 48 
DEFS pseudo-operation, x 
DEFW pseudo-operation, x, 48 
Delay program, 391-93 
Deletion of a substring, 308-12 
Device numbers, 56-57, 373-84 
Digit (4-bit) shift, 90, 152-53, 256, 257, 264 
Digit swap, 90 
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Direct addressing, 10-11, 13 
arithmetic and logical instructions, lack of, 2 
parentheses around addresses, x, 149, 155 
Direction of stack growth, 46 
Disassembly of numerical operation codes, 
439-4] 
Division, 80 
by 2, 80, 333 
by 4, 80 
by 10, 168 
by 100, 168 
decimal, 260-65 
multiple-precision binary, 239-44 
remainder, sign of, 221 
simple cases, 43, 80 
16-bit, 220-24 
DJINZ, 30, 32 
Documentation of programs, 60 
Double operands in arithmetic instructions, 16 
Doubling an index, 35, 39 
Drivers (I/O routines), 57, 373-74 
Dynamic allocation of memory, 49, 66, 125-26 


EBCDIC to ASCII conversion, 192-94 
EI, 65, 124 
position in return sequence, 121 
8080 additions, 4, 22, 29, 74, 124 
incompatibility (Parity flag), 29 
Enabling and disabling interrupts, 124-25 
accepting an interrupt, 64 
DI, 124 
EI, 65, 124 
interrupt status, saving and restoring, 124-25 
interrupt status, testing, 105, 107, 124-25 
unserviced output interrupt, 405 
when required, 158-59 
END pseudo-operation, x 
Endless loop (wait) instruction, 123 
EQU pseudo-operation, x 
Equal values, comparison of, 26-27, 142 
Error-correcting codes. See CRC — 
Error-detecting codes. See Parity 
Error handling, 162-63 
Errors in programs, 139-59 
Even parity (parity/ overflow) flag, 29 
EX, 64, 96, 97, 99, 121, 444 
EX DE,HL, 10 
EX (SP), 12, 67, 119, 121 
Exchange instructions, 99-100 
Exchanging elements, 34 
Exchanging pointers, 100 
EXCLUSIVE OR function, 18, 19 
EXCLUSIVE OR instructions, 87 
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Execution time, reducing, 67-68 
Execution times for instructions, 442-52 
Extend instructions, 84 

EXX, 64 


F (flag) register, ix, 86-87, 95, 97, 434 
FIFO buffer (queue), 45-46, 414 
Fill memory, 99, 195-97 
Flag register, ix, 86-87, 95, 97, 434 
Flags, 434, 453 
instructions, effects of, 3, 453 
loading, 95 
organization in flag register, 1x, 434 
storing, 97 
summary, 453 
use, 31 
Format errors, 149-51 
Format for storing 16-bit addresses, 5, 11 


H (half-carry) flag, 434 
H (indicating hexadecimal number), x, 150 
Handshake, 61-62 
Head of a queue, 45, 414 
Hexadecimal ASCII to binary conversion, 175-77 
Hexadecimal to ASCII conversion, 172-74 
Hexadecimal numbers, zero in front, 149 
HL register pair, special features, 2, 8-9 

use, 3, 5 


IFF1 (interrupt flip-flop 1), 435 

IFF2 (interrupt flip-flop 2), 105, 107, 123, 124-25, 
435 

Immediate addressing, I1, 17 
assembler notation, 17, 148 
default, 17, 148 


use of, 11 

Implicit effects of instructions, 152-53 

INC, 3, 4 
differences between 8- and 16-bit versions, 4 
flags, 3, 4 


Increment instructions, 76-77 
decimal, 77, 124 
setting Carry, 76 
IND, 54 
Indexed addressing, 33-35, 38-39, 127-29 
data structures, 5, 377-78, 384 
generalized form, 3 
limitations, 3 
loading, 12 
parameter retrieval, 47-48 
storing, 14 
Indexed call, 119-20, 352-55 
leaving register pairs unchanged, 353-54 


Indexed jump, 39, 103, 119 
Indexing of arrays, 33-35, 201-16 
byte arrays, 42-43, 201-04 
multidimensional arrays, 209-16 
two-dimensional byte array, 42-43, 201-04 
two-dimensional word array, 205-08 
word arrays, 205-08 
Index registers, 3 
backup to HL, 9 
features, 9 
instructions, 6 
secondary status, 4 
uses, 5 
Indirect addressing, 3, 11-12, 13, 126-27 
indexed addressing with zero offset, 12 
jump instructions, 102-03 
multilevel versions, 127 
subroutine calls, 119-20 
Indirect call, 119-20, 352-55 
Indirect jump, 102-03 
INDR, 54 
INI, 54, 55 
INIR, 54, 55 
Initialization 
arrays, 195-97 
CTC, 388 
indirect addresses, 15 
interrupt service routines, 64-66 
interrupt vectors, 398, 408, 418 
I/O devices, 63-64, 385-90 
PIO, 63-64, 390, 410-11 
RAM, 15-16, 195-97 
SIO, 388-89, 400-02, 421-22 
Initialization errors, 154 
Input/Output (I/O) 
block I/O instructions, 54-55 
control block (IOCB), 373-84 
device-independent, 56-57 
device table, 56-57, 373-84 
differences between input and output, 157, 395 
errors, 156-58 
indirect addressing, 51-52, 58 
initialization, 63-64, 385-90 
instructions, 51-55, 452 
interrupt-driven, 64-66, 394-424 
logical devices, 56-57 
output, generalized, 365-67 
peripheral chips, 58 
physical devices, 56-57 
read-only ports, 53, 158 
status and control, 57-58 
terminal handler, 356-64 
write-only ports, 53-54, 57-58, 62, 65-66, 157 
Inserting a character, 181 
Insertion into a string, 313-18 
Instruction execution times, 442-52 


Instruction set, 433-55 
alphabetical list, 436-39 
asymmetry, 5 
numerical list, 439-41 
Interrupt enable flip-flops (IFF1 and 
IFF2), 4, 105, 107, 123, 124-25, 435 
Interrupt latency, 65 
Interrupt response, 64, 435 
Interrupts. See also Enabling and disabling 
interrupts 
buffered, 413-24 
elapsed time, 425-32 
handshake, 394-424 
initialization, 158, 398, 408, 418, 427-28 
instructions, 446 
latency, 65 
modes, 64, 158, 398, 435 
order in stack, 65 
PIO, 60, 404-12, 459, 460, 461 
programming guidelines, 64-66, 158-59 
real-time clock, 425-32 
reenabling, 64, 123, 159, 410 
response, 64, 435 
service routines, 394-432 
structure, 435 
Interrupt service routines, 394-432 
CTC, 425-32 
errors, 158-59 
examples, 394-432 
main program, communicating with, 159, 
394-95, 413-14 
PIO, 404-12 
programming guidelines, 64-66, 158-59 
real-time clock, 425-32 
SIO, 394-403, 413-24 
terminating instructions, 66 
Interrupt status, 5, 105, 107, 124-25 
Interrupt vector register, 95, 97, 398, 435 
Inverted borrow in subtraction, 75, 76, 142 
Inverting bits, 18-20, 88 
Inverting decision logic, 140, 142 
I/O control block (IOCB), 373-84 
example, 381 
format, 374 
I/O device table, 56-57, 373-84 
I/O instructions, 452 


J 


JP, 24-31 
addressing terminology, 148 
block move or block compare, 37 
overflow branches, 28-30, 112-13 

JR, 25-29, 68 
comparison with absolute branches, 3-4 
flag limitations, 3-4 

Jump and link, 103-04 
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Jump instructions, 450 
Jump table, 39, 103, 119, 149, 352-55 


L 


LD, 10-12, 13, 14-16 
8080 instruction set, additions, 38 
order of operands, 10, 141 
LDD, 36, 37 
LDDR, 36, 37, 181, 200, 318 
LDI, 36, 37 
LDIR, 36, 37, 99, 196, 200, 295, 306, 311, 318 
Limit checking, 27-30 
Linked list, 45-46, 373, 374, 377-79 
List processing, 45-46, 377-79 
Load instructions, 10-16, 94-96 
8-bit, 442 
flags, 3, 142 
order of operands, 10, 141 
16-bit, 443 
Logical I/O devices, 56-57, 373-84 
Logical instructions, 85-94, 445 
addressing modes, 2 
Carry, clearing of, 3, 143 
limitations, 2 
Logical shift, 20, 22, 23, 89-90, 276-81 
Logical sum, 87. See also Parity 
Long instructions, 4 
Lookup tables, 38-39, 41, 68, 69, 125, 189-94 
Loops, 30, 32-33 
reorganizing to save time, 67 
Lower-case ASCII letters, 187-88 


Masking bits, 18, 268, 271 

Maximum, 325-27 

Median (of 3 elements), 342-44 

Memory fill, 99, 195-97 

Memory-mapped I/O, 51-53 

Memory test, 347-51 

Memory usage, reduction of, 68-69 

Millisecond delay program, 391-93 

Minimum, 328-30 

Missing addressing modes, 126-37 

Missing instructions, 3, 71-126 

Move instructions, 97-99 

Move left (bottom-up), 198, 199-200 

Move multiple, 99 

Move right (top-down), 198, 199-200 

Multibit shifts, 23, 273-87 

Multibyte entries in arrays or tables, 34-35, 38-39, 
125, 205-16 

Multidimensional arrays, 209-16 

Multilevel indirect addressing, 127 

Multiple names for registers, 2 

Multiple-precision arithmetic, 41-42, 228-66 

Multiple-precision shifts, 273-87 
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Multiple-precision shifts (continued) 
arithmetic right, 273-75 
digit (4-bit) left, 264 
logical left, 276-78 
logical right, 279-81 
rotate left, 285-87 
rotate right, 282-84 
Multiplexing displays, 62 
Multiplication, 42-43, 78-79 
by a small integer, 42-43 
by 10, 171, 185 
by 2, 35 
decimal, 254-59 
multiple-precision, 234-38, 254-59 
16-bit, 217-19 
Multiway branches (jump table), 39, 103, 119, 352-55 


N (add/subtract) flag, 74, 434 
Negative, calculation of, 82-83, 222-23 
Negative logic, 89, 157 

Nested loops, 32-33 

New line string, 356, 361-62 

Nibble (4 bits), 171, 173 

Nine’s complement, 83 
Non-maskable interrupt, 65, 66, 123 
NOP, filling with, 195 
Normalization, 90-91 

Normalizing array bounds, 215-16 
NOT instructions, 87-89, 268 
Numerical comparisons, 26-31 


Oo 


One-dimensional arrays, 33-38 
One’s complement, 87-89 
Operation (op) codes 
alphabetical order, 436-39 
numerical order, 439-41 
OR, 18, 86-87, 268, 272 
Ordering elements, 34 
ORG pseudo-operation, x 
OTDR, 54 
OTIR, 54, 387 
OUTD, 54 
OUTI, 54, 55, 153 
Output interrupts, unserviced, 395, 405 
Output line routine, 365-67 
Overflow (P/V) flag, 3, 28 
branches (PE, PO), 28, 29, 112 
Overflow of a stack, 46, 108, 109 
Overflow, two’s complement, 28-30, 112-13 
Overlapping memory areas, 198-200 


P/V (parity/ overflow) flag, 434. See also Parity/ 
overflow flag 
Parameters, passing, 46-51, 161 


Parentheses around addresses (indicating “con- 
tents of”), x, 149, 155 
Parity/ overflow flag, 3, 35-36, 434 
block moves and compares, 35-36, 37 
interrupt enable flag, 4, 124-25 
overflow indicator, 28, 112, 225, 227 
reversed polarity in block move and compare, 37 
Passing parameters, 46-51, 161 
memory, 47-48 
registers, 46-47 
stack, 49-51 
subroutine convention, 161 
PC register. See Program counter 
Physical I/O device, 56-57 
PIO (parallel input/output device), 58-64, 457-62 
addressing, 59-60 
control lines, 61-62 
initialization, 63-64, 390, 410-11 
interrupt-driven I/O, 404-12 
operating modes, 61-62 
reference, 457-62 
registers, 59-60 
Pointer 
exchanging, 99-100, 243, 265 
loading, 96 
Polling, 57-58 
POP, 12 
Pop instructions, 122-23 
Position of a substring, 297-301 
Postdecrement, 133-34 
Postincrement, 12, 130-31 
Postindexing, 136-37 
Predecrement, 12, 131-32 
Preincrement, 129-30 
Preindexing, 134-36 
Primed (alternate) registers, 4, 96, 97 
Processor status (flag) register, 434 
Program counter 
CALL, 118-20 
RET, 120-21 
Programmable I/O devices, 58 
advantages, 58 
CTC, 388, 427-28 
initialization, 385-90 
operating modes, 58 
PIO, 58-64, 404-12, 457-62 
SIO, 388-89, 394-403, 413-24 
Programming model of microprocessor, 433 
Pseudo-operations, x, 455 
PUSH, 14, 141 
Push instructions, 122 


Queue, 45-46, 414 
Quicksort, 336-46 
Quotation marks around ASCII string, x 


RAM, 481 
filling, 99, 195-97 
initialization, 15-16, 154 
saving data, 13-14 
testing, 347-51 
Read-only memory, 48 
Read-only ports, 53, 158 
Ready flag (for use with interrupts), 394-95 
Real-time clock, 425-32 
Recursive program (quicksort), 336-46 
Reenabling interrupts, 65, 124-25 
Reentrancy, 47 
Refresh (R) register, 95, 97 
Register pairs, ix, 2, 433 
instructions, 6, 8 
loading, I1 
Registers, 5-15 
functions, 5 
instructions, 6-8 
length, 1x 
names, 2 
order in stack, 65 
passing parameters, 46-47 
primed, 4, 96, 97 
programming model, 433 
saving and restoring, 65, 121 
secondary, 4 
special features, 8-9 
transfers, 10 
Register transfers, 10 
Relative branches, 3-4, 32 
RES, 18, 19, 53-54 
Reset 
CTC, 388 
PIO, 61, 63 
SIO, 389 
Restart instructions, 64, 65, 451, 454 
RETI, 66 
RETN, 66 
Return address, changing of, 120-21 
Return instructions, 120-21 
Return from interrupt instructions, 121 
Return with skip instructions, 120-21 
RL, 20, 53 
RLC, 20 
RLD, 264 
ROM (read-only memory), 48 
Rotation (circular shift), 20-22, 24, 91-92, 282-87 
Row major order (for storing arrays), 205, 209 
RR, 20, 80 
RRC, 20 
RRD, 152-53, 257 
RST, 64, 65, 451, 454 
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Saving and restoring interrupt status, 5, 105, 107, 
124-25 
Saving and restoring registers, 12, 14, 64-66, 121 
SBC A,A (extend Carry across A), 84 
Searching, 35-38, 331-35 
Secondary instructions, 4, 38 
Secondary registers, 4 
Semicolon indicating comment, x 
Serial input/output, 394-403, 413-24 
SET, 18-20, 53 
Set instructions, 102 
Set Origin (ORG) pseudo-operation, x 
Setting bits to 1, 18-20, 102 
Setting directions 
initialization, 158 
PIO (control mode), 60, 63-64, 459 
Setting flags, 86-87 
Shift instructions, 20-24, 89-92, 448 
byte, 181 
diagrams, 21-23 
digit, 152-53 
multibit, 23, 273-87 
multibyte, 273-87 
32-bit left shift, 223 
24-bit left shift, 180 
Sign byte, 184-85 
Sign extension, 20, 23-24, 273-75 
Sign flag, 28-30, 142-43 
Sign function, 84 
Signed division, 220-24 
Signed branches, 28-30, 112-13 
Signed numbers, 28-30 
Signs, comparison of, 29, 222 
SIO (Serial Input/Output Device), 388-89, 
394- 403, 413-24 
16-bit address format, 5 
16-bit operations, 217-27 
absolute value, 83 
addition, 72-73, 74 
average, 333 
comparison, 81-82, 225-27 
counter, 32-33, 35 
division, 220-24 
flags, effect on, 3 
indexing, 128 
instructions, 443, 447 
multiplication, 217-19 
pop, 12 
push, 14 
registers, 1x 
shifts, 89-92 
subtraction, 27, 74-76 
test for zero, 93 
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6800 microprocessor, differences from, 5 
6809 microprocessor, differences from, 5 
Skip instructions, 118, 120-21 
SLA, 20 
Slow instructions, 4, 38 
Software delay, 391-93 
Software stack, 46 
Sorting, 336-46 
references, 338 
SP register. See Stack pointer 
Special cases, 162-63 
Special features of processor, 2-5 
SRA, 20, 23, 80 
SRL, 20, 80 
Stack, 12, 14, 49-51 
cleaning, 49, 50 
data transfers, 12, 14 
diagrams, 50, 51 
downward growth, 5, 12 
overflow, 46 
passing parameters, 49-51 
pointer, 6, 7, 12, 49-51 
POP, 12 
PUSH, 14 
saving registers, 65 
software, 46 
underflow, 46 
Stack pointer 
automatic change when used, 12 
comparison, 82 
contents, 5, 12 
decrementing, 12 
definition, 12 
dynamic allocation of memory, 49, 66, 125-26 
features, 9 
incrementing, 14 
moving to HL, 49 
transfers, 98 
Stack transfers, 12, 14, 46 
Status bit. See Flags; Flag register 
Status signals, 57-58 
Status values in I/O, 375 
Store instructions, effect on flags (none), 3 
String operations, 39-40, 288-318 
abbreviations, recognition of, 289, 297, 298 
compacting, 311 
comparison, 288-91 
concatenation, 292-96 
copying a substring, 302-07 
deletion, 308-12 
insertion, 313-18 
matching a substring, 300 
position of substring, 297-301 
search, 39-40 


Strobe, 61-62 
SUB, single operand in, 16 
Subroutine call, 49, 118-20 
saving memory, 68-69 
variable addresses, 118-20 
Subroutine linkage, 49, 103-04, 161 
Subscript, size of, 206, 209, 210 
Subtraction, 74-76 
BCD, 74-76, 231-33 
binary, 74-76, 231-33 
Carry flag, 27, 76 
decimal, 74-76, 231-33 
8-bit, 74-76 
inverted borrow, 75, 76, 142 
multiple-precision, 231-33 
reverse, 75 
16-bit, 27, 74-76 
Subtraction instructions, 74-76 
in reverse, 75 
with borrow, 76 
without borrow, 74-75 
Summation, 33 
binary, 33 
8-bit, 33, 319-21 
16-bit, 322-24 
Systems programs, conflict with, 140 


T 


Table, 38-39, 41, 68, 69, 125, 189-94 
Table lookup, 38-39, 41, 125 
Tail of a queue, 414 
Ten’s complement, 82-83 
Terminal I/O, 356-67 
Testing, 92-94 
array, 241, 262 
bits, 18, 19, 25-26, 85 
bytes, 92-93 
multiple-precision number, 241, 262 
16-bit number, 93 
32-bit left shift, 223 
Threaded code, 44 
Threshold checking, 27-31 
Timeout, 391-93 
Timing for instructions, 442-52 
Top of stack, 12 
Transfer instructions, effect on flags, 3 
Translate instructions, 125 
Trivial cases, 162 
True comparison, 35, 38 
24-bit left shift, 180 
Two-byte entries, 34-35, 38-39, 125 
Two-dimensional arrays, 42-43, 201-08 
Two’s complement, 82-83 
Two’s complement overflow, 28-30, 112-13 
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U Z 
Unconditional jump instructions, 102-04 Zero flag, 142 
Underflow of stack, 46 block compares, 37 
Upside-down addresses, 5, 11 block I/O, 54 
branches, 142 
Vv comparisons, 26 
Validity check for BCD number, 124 inversion in masking, 19, 25 
load instructions, 3 
wW masking, 19, 93 
Wait instructions, 123 position in flag register, ix, 434 
Walking bit test, 347-49 transfer instructions, 3 
Wraparound of buffer, 414 uses, 25-27, 31 


Write-only ports, 53-54, 57-58, 62, 65-66, 157 Zero in front of hexadecimal numbers, 149 
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